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Notice 


Apple Computer reserves the right to make improvements in the product 
described in this manual at any time and without notice. 





Disclaimer of All Warranties And Liabilities 


a a ee ees ee 
Apple Computer makes no warranties, either express or implied, with respect to 
this manual or with respect to the software described in this manual, its 
quality, performance, merchantability, or fitness for any particular purpose. Apple 
Computer software is sold or licensed “as is.’ The entire risk as to its quality and 
performance is with the buyer. Should the programs prove defective following 
their purchase, the buyer (and not Apple Computer, its distributor, or its retailer) 
assumes the entire cost of all necessary servicing, repair, or correction and any 
incidental or consequential damages. In no event will Apple Computer be liable 
for direct, indirect, incidental, or consequential damages resulting from any defect 
in the software, even if Apple Computer has been advised of the possibility of 
such damages. Some states do not allow the exclusion or limitation of implied 
warranties or liability for incidental or consequential damages, so the above 
limitation or exclusion may not apply to you. 


This manual is copyrighted. All rights are reserved. This document may not, in 
whole or part, be copied, photocopied, reproduced, translated or reduced to any 
electronic medium or machine readable form without prior consent, in writing, 
from Apple Computer. 


© 1981 by Apple Computer - 
10260 Bandley Drive 
Cupertino, California 95014 
(408)-996-4040- 
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The word Apple and the Apple logo are registered trademarks of Apple Computer. 
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Getting Started 





This Owner's Guide is the first book you should read after getting 
your new Apple Ill. This Guide has three functions. First, it introduces 
you to your Apple Ill: how to unpack it, set it up, and start it working. 
second, it shows you some fundamental operating procedures to 
follow whenever you use your Apple. Third, it tells you about the 
structure and operation of the Apple and its operating system. 


You should read the first chapter as you unpack your Apple. It not 
only tells you how to unpack, set up, and start up your Apple but it 
also contains important information about the care and handling of 
your computer. 


The second chapter leads you through the standard procedures you 
will follow whenever you use your Apple. Here you will learn about all 
the ways you can control the Apple from the keyboard. The 
information in this chapter is important and helpful: you should read 
this chapter carefully and attempt all the examples it contains. 


The third chapter describes the Apple's operating system, which is 
the means of communication between you and the machine. This 
chapter introduces the concepts of devices, files, and pathnames. 


The fourth chapter describes some standard programs that are 
supplied with your Apple Ill. The chapter tells you how to back up 
and format diskettes, and how to set up your copy of the operating 
system to fit the hardware you have. 





The fifth chapter describes the Filer. This program gives you access 
to the operating system, and lets you use and move the information 
you have stored on your diskettes. 


The sixth chapter describes the parts that make up the machine itself. 
If you're interested in the capabilities of the built-in devices of 

your Apple Ill or in how to install external devices, this chapter will 
provide the information you need. 


At the end of this Guide are several appendices that contain 
important information. There's also a Glossary that explains any 
terms that may be unfamiliar to you, and an Index to help you find 
things. 


lf your dealer has not already done so, please take a few minutes to 
complete your Apple IIl Warranty Registration card and drop it in the 
mail. This will ensure that you receive the newsletters and other 
information frequently mailed to Apple owners. 


Symbols and Labels 





Occasionally in this Guide you will see an indented paragraph with 
the symbol 


This means the indented paragraph contains 


information that will give you a helping hand. 


This informs you that you should be alert: the 
indented paragraph describes a potential hazard to 
which you should be alert. 


Read carefully—the indented paragraph warns you of 
a dangerous situation in which you could lose some 


data you've stored, or possibly damage your Apple III. 





First Steps 


Unpacking 





Your Apple Ill is packed in a large cardboard shipping carton. This 
manual was packed in a small shipping carton attached to the Apple 
III's carton. Enclosed with each carton is a packing list; make sure 
that each carton you received contains everything named on its list. 


The envelope containing the packing list for the Apple Ill’s carton 
also contains instructions on how to unpack your computer. Save the 
packing materials in case you wish to transport your Apple III, or 
must return it to your dealer or the factory for service. 


To use your Apple Ill, you need the contents of the Apple III's carton, 
the contents of the box in which this manual was packed, and a video 
display. If you are using a video display other than the Apple Ill’s 
recommended black-and-white video monitor, ask your Apple dealer 
to assist you in connecting your monitor to your Apple Ill. 


Plugging In 





Almost everything you connect to your Apple III plugs directly into the 
back of the computer. Place the Apple III on a flat surface and turn it 
around so that the back is facing you. 





The Back of the Apple III 


Now find the power cord and the video cable, which are included in 
the Apple Ill’s carton. These are the only two things you need to 
connect to the Apple Ill at this time. If you have purchased any 
peripheral devices for your Apple III (such as additional disk drives), 
please wait until you finish this chapter before you install them. 


The Power Cord 


The power cord plugs into the right side of the back of the Apple Ill. 
The power switch is right next to the power plug. It has two positions: 
to the left (marked “O", zero) is OFF and to the right (marked ‘1”) is 
ON. Make sure the power switch is OFF before you plug in the power 
cord. Plug the other end of the power cord into a standard three- 
prong grounded wall outlet. 


) For your own Safety, and to protect the Apple III 
against static charges, you should always make sure 
that your Apple Ill is grounded. If you cannot connect 
your Apple Ill to a three-prong grounded wall outlet, 
then use a three-prong to two-prong adaptor, making 
sure to connect the ground wire on the adaptor to a 
mounting screw on the wall outlet. If you must use an 
extension cord to plug in your Apple III, make sure it 
is a three-wire grounded cord. 


Connecting the Monitor 


Attach one end of the video cable to the connector marked B/W 
VIDEO on the back of the Apple Ill. Attach the other end of the 
connector to the video monitor, to the jack marked VIDEO IN. Make 
sure all connectors fit firmly. After you connect the video cable, plug 
the monitor’s power cord into a wall outlet. 


lf you are using a monitor or television other than the black-and- 
white video monitor recommended by Apple, please see your dealer 
for assistance in connecting it to your Apple Ill. 


The video cable is tightly coiled for shipping 


purposes. Sometimes the coils in the cable set up a 

magnetic field that kills the video signal before it can 
get to your monitor. Be sure to uncoil and straighten 
your video cable before connecting it. 





Connecting the Monitor 


Handling Diskettes 





Now youre ready to start using your Apple Ill. Most of the programs 
you will use are stored on diskettes. These are coated plastic disks on 
which the Apple Ill can store information and read it back later. The 


Apple Ill records information on the surface of a diskette in much the 
same way as a tape recorder records music on a magnetic tape. 


Each diskette is protected by a square black covering, about five 
inches on a side. This covering is sealed shut and should never be 
opened. The Apple Ill reads and writes information on the diskette 
through the oval slots in the covering. YOU SHOULD NEVER TOUCH 
THE SURFACE OF THE DISKETTE ITSELF; handle it only by its black 
protective covering. For more information on the use and care of 
diskettes, see Appendix B. 


Inserting and Removing Diskettes 


The disk drive is above the keyboard on the right side of the face of 
the Apple Ill. Remove the protective tape from the door to the disk 
drive, then open the door by pulling out on the door’s bottom edge. 





Opening the Disk Drive 


Diskettes are included in the box that contained this manual. Find the 
diskette labeled APPLE III DEMONSTRATION DISKETTE and slide it 
out of its paper sleeve. Hold it in your right hand, between your 
thumb and forefinger, with the label upwards. 


A Good 
RULE OF THUMB: 


Hold a diskette with the label on top, your right thumb 
on the label, and the oval slot pointing at the drive. 
This is the correct orientation for inserting the 
diskette into the disk drive. 


Insert the far edge of the diskette (the edge with the oval cutout) into 
the slot in the disk drive. The label should enter the drive last. Push 
the diskette in until it is entirely inside the drive. Push gently; if you 
bend the diskette, you may damage it permanently. If the diskette 
does not go in smoothly, pull it out and try again, wiggling it if 
necessary. 





Inserting a Diskette 


Close the disk drive door by pushing it down gently until it clicks into 
place. If you can't close the door, the diskette isn’t all the way in; try 
removing the diskette and inserting it again. 


When you want to remove a diskette from the drive, open it and pull 
the diskette out (and a little upward) without bending it, and put it 
back into its protective paper sleeve. 





Starting Up 


Now that the diskette is in the drive, you're ready to go. First turn on 
your video monitor. Now reach behind the Apple Ill and turn the 
power switch ON. Immediately the “ON” light on the keyboard will 
light up, the screen will flash briefly, and the red light under the door 
of the disk drive will come on. The “ON” light tells you that your Apple 
Ill is on and running; the red light on the disk drive tells you that it is 
using the diskette. 


You should not open the drive door, remove a diskette, 


or turn the Apple Ill’s power off while the disk drive's 
red light is on. Doing so might interrupt the Apple III 
while it is writing on the diskette, causing some of the 
data to be unusable. 


The screen should display something like this: 


APPLE II! 
Sos 7.1 24-OCT-86 


oO” 


‘C> COPYRIGHT 1986 B‘ 
APPLE COMPUTER INC. 


THU. G@1I-JAN-@G@ 21:55 





Demonstration Diskette 
startup Screen 





SS If the screen shows the word RETRY in the upper left- 
hand corner, make sure you've inserted the diskette 
correctly, then hold down the key marked CONTROL 
on the left side of the keyboard and at the same time 
press and release the flat button marked RESET on 
the back of the right side of the keyboard. Now 
release the CONTROL key. If RETRY appears again, or 
if the word DIAGNOSTIC appeared in the upper left- 
hand corner, something is wrong with your Apple III: 
see Appendix A for instructions. If you get a similar 
message at any other time, see Appendix A. 


If you have a Monitor Ill, use the vertical-hold and vertical-size 
controls to stabilize the picture in the middle of the screen; adjust the 
brightness and contrast controls on your monitor so that the image is 
clear and sharp. The contrast control is on the front of the monitor; 
the others are on the back. 


lf you have a Sanyo monitor, use the horizontal-hold and vertical-hold 
controls to stabilize the picture in the middle of the screen; adjust the 
brightness and contrast controls on your monitor so that the image is 
clear and sharp. 


ole [11 Demonstration Diskette 





The Demonstration diskette contains programs that demonstrate 
some features and capabilities of your Apple Ill. If you have been 
following our instructions, some demonstrations are now performing 
on your monitor's screen. The demonstrations are a continuous cycle; 
once you have started the programs, they will repeat until you stop 
them or turn off the Apple Ill. 


There are other demonstration programs on the diskette that are not 
part of the main cycle. These programs are interactive; they need you 
to control their operation. To use these interactive programs, press 
the key marked ESCAPE in the upper-left corner of the keyboard. The 
main demonstrations will immediately cease and the screen will show 
a display similar to this: 


. Console Demonstration 
. Read & Set the Clock/’Calendar 
. Try the Tupesahead Buffer 


. Adjust Video Monitor 


tupe the number of the 
stration you wish to see 


ee Sts 


J 





Demonstration Menu 


This list of numbered descriptions is called a menu. It works like a 
breakfast menu at a cafe. If you want scrambled eggs with hash 
brown potatoes you can just say, “I'll have a number 5”. If you want to 
see demonstration number 1, you tell the Apple Ill that you want it by 
pressing either key marked °1”. 


Each of the demonstration programs contains instructions on what it 
does and how you use it. Some of the demonstrations are referred to 
in the next chapter, but you can experiment with them now. When you 
want to leave a demonstration and go back to the main menu, press 
the ESCAPE key. 


Turning It Off 


The Apple Ill, like many other electronic devices, warms up when you 
leave it on, and works better if it stays at a constant temperature 
rather than being continually turned on and off. It is safe to leave it 
on for prolonged periods, if it is properly ventilated; and it uses less 
power than a 100 watt light bulb. (Some Apple Ills are used for 
controllers and such: they may be left on for months at a time.) If 
you're going to be using your Apple Ill again within a few hours, leave 








it turned on. You should, however, turn off the monitor: leaving it on 
decreases the life of its picture tube. 


The electronic components in which the Apple Ill 


temporarily stores information, collectively called the 
main memory, are volatile: that is, whatever you've 
stored in it will disappear when you turn off the Apple 
lll’s power. This means that you shouldn't turn your 
Apple Ill off when you've just typed in a lot of 
information and haven't saved it anywhere. When you 
put information into your Apple Ill, make sure you 
save it onto a diskette or other mass storage device 
before you turn the computer off. The manual for the 
particular application or system youre using will tell 
you how to do this. 


Installing Disk Drives 





lf you have additional Apple Disk Ill drives, now is a good time to 
install them. Your first disk drive, not including your built-in disk 
drive, plugs directly into the back of Apple Ill. 


*** IMPORTANT *** 


Before connecting or disconnecting 
ANYTHING 
on the Apple Ill, 
TURN OFF THE POWER. 
This is a MUST. 


Unpack the disk drive and unwrap the long, flat cable attached to It. 
Look at the connector at the end of this cable: one side has a small 
rectangular bump on it. Hold the connector with this bump on top 

and plug the connector into the “FLOPPY DISKS” connector on the 
Apple Ill. The bump should slide into the matching notch in the Apple 
III's connector. Press the connectors together until they are firmly 
seated, but dont force them: if they don't go together easily, they are 
probably crooked. 





lf you have a second external disk drive, plug it into the back of the 
first disk drive in exactly the same way as you plugged that drive into 
the Apple Ill. A third external drive plugs into the second in the same 
manner. Your Apple Ill can support up to three external disk drives. 


lf you have two or more external drives, you will have to reconfigure 
your system before you can use all of them. How to do this is 
explained in the chapter “The Utilities Diskette”. 





Attachment of External Drives 


Do not attempt to attach more than three external 


disk drives to your Apple Ill! Even though you can 
physically attach more, the electronics in the Apple III 
cannot handle more than three external drives. 
Attaching more drives may damage the Apple Ill, the 
drives, or both. 


We will tell you how to install other devices in the section “The Back”, 
in the chapter “The Machine’. 





Using Your Apple III 


Standard Procedures 





This chapter will guide you through your first hands-on experience 
with the Apple Ill and show you how to use its standard operating 
procedures. The techniques explained in this chapter will be useful to 
you every time you use your Apple Ill, no matter what language or 
application you are using. 


A note about the examples: parts of this chapter will ask you toruna 
program on the Apple III and try out the commands. It's important 
that you actually try the examples so that you see what they do and 
how they are used. The examples were written with the assumption 
that you have the Apple Ill set up and running, and that you are doing 
the examples as they are presented. If you read the manual without 
actually trying everything on the Apple Ill, or if you try to learn how to 
use the Apple Ill without reading the manual, you may not learn how 
to use some of the powerful functions of the Apple Ill. 


Even though the manual shows you many ways to use the features of 
the Apple Ill, there are still very many more ways to use them. So play 
and experiment: try new and different things. It’s the only way you'll 
learn the true power of your Apple IIl. 


The Usual Startup Procedure 





You use the same general procedure to start up your Apple III each 
time you turn it on. It's the same procedure you used to start up the 
Demonstration diskette in the last chapter. This procedure is called a 
bootstrap operation, or “booting the system”. The term dates back to 
the early days of computing and refers to the steps the computer 
takes to load the software it needs to operate, as if it were tugging on 
its own bootstraps. 





The usual procedure for booting your Apple III is to insert a diskette 
in the Apple IIl’s built-in disk drive, close the drive door, and turn the 
power switch on. If the power is already on, the procedure for 
booting is to hold down the CONTROL key while you press and 
release the RESET button behind the keyboard. 





Booting Up 


As soon as you release the RESET button, the disk drive's red light 
comes on and the drive starts to whir. In a matter of moments the 
computer will have taken the information it needs from the diskette 
and started running a language or special program. The amount of 
time that it takes the computer to read the needed information varies 
from application to application. 


Boot Diskettes 


You must boot your Apple Ill using a diskette that has been specially 
prepared for that purpose. Such a diskette is called a boot diskette. A 
boot diskette is just like any other diskette, except that it contains 
three special things: 


e An operating system. This is a program that controls the 
machine's operation in a uniform manner. 


e <Aset of device drivers. These are smaller programs that 
enable the operating system to communicate with 





input/output devices such as the keyboard, screen, printer, 
and disk drives. 


e An interpreter. This is a program that lets the Apple run 
programs written in a given language, such as Apple 
Business BASIC, Apple Pascal, or even VisiCalc. 


Every boot diskette must contain these three items. If you try to boot 
your Apple Ill using a diskette that lacks one or more of these, the 
Apple Ill will respond with the message 


KERNEL FILE NOT FOUND 


or something similar, and then “hang” (do nothing) until you insert a 
proper boot diskette and try again. 


Whenever you boot a diskette, you automatically boot a 
language. The only way to switch from one language to another 
is to reboot the system with the other language's boot diskette. 


Turnkey Systems 


Most boot diskettes also have a fourth important item: a program 
that runs automatically whenever you boot the Apple III using that 
diskette. Such diskettes are called turnkey diskettes. Suppose a 
doctor has a program that schedules patients appointments. Ideally, 
the office staff should be able to turn on the Apple Ill and 
immediately begin using the appointment system. The staff members 
wouldn't need to know anything about the program or languages, 
just how to use the appointment system. As far as they are 
concerned, the computer is simply an appointment maker. 


This is the essence of a turnkey system: from the user's point of view 
the computer is simply a device for one particular application, and 
getting it started is as simple as turning a key in a lock. Here, the 
“key’ is the Apple III's power switch. A well-designed turnkey system 
can be operated by anyone. 


The Demonstration diskette you used in the first chapter is a turnkey 
diskette; so is the Apple Ill Utilities diskette, which you will use later 
on in this chapter. Many of the programs you buy for your Apple Ill 
will be on turnkey diskettes. If you are going to be writing your own 
programs, you can learn how to create turnkey diskettes by reading 
the manual for the programming language you are going to use. 


Using the Console 





Together, the Apple III's video display and keyboard are called the 
console. Through the console, you send information to, and receive 
information from, the program or application you are using. Just as 
you use the dashboard and pedals of your car to control the car and 
monitor its operation, you use the console of your Apple Ill to control 
and monitor everything the Apple Ill does. 


There are standard ways that the console lets you enter information 
and standard ways that It displays information on the screen. 
Whatever application you are using, you will usually use the console 
in the same general way. 


The best way to learn about the console is to use it. There's a 
program on the Demonstration diskette that allows you to use the 
console alone, without using another application or program. This 
will give you practice in using the general features of the console. 
Think of it as a driving simulator. Once you have learned the 
mechanics of driving, you are prepared for all the different conditions 
you may encounter. 


To use this program, place the Demonstration diskette in the 

Apple III's built-in disk drive and use the standard procedure for 
booting diskettes, described above. Once the demonstrations start, 
press the ESCAPE key on the Apple Ill’s keyboard. You should see the 
Demonstration menu: 


aa 
i 4 4 ' 


. Console Demonstration 

. Read & Set the Clock/Calendar 
. Iry the Typeahead Buffer 

. Adjust Video Monitor 


ype the number of the 
ee ration you wish to see. 


| kz ta 





The Demonstration Menu 


Choose the CONSOLE DEMONSTRATION by pressing the number 1. 
Immediately the disk drive will start to whir, and after some 
introductory instructions, the screen will go blank, with a small white 
square in the upper-left corner. Try typing something. As you press 
each key, its character will appear on the Apple Ill’s screen. (The 128 
different characters that the Apple III can display on its screen are 
called its character set.) 


This demonstration program reads each character you type from the 
keyboard and immediately writes it onto the screen. The process of 
automatically displaying everything that is typed is called echoing. 


Most programs and applications echo the characters you type, but 
they also interpret what you're typing. Some programs examine each 
keystroke for meaning as soon as you type it; others wait until you hit 
a special key (such as RETURN or ENTER), or until you type a certain 
number of characters, before they look at what you've typed. 


The following exercises acquaint you with the the most common uses 
of the console: typing, erasing minor mistakes, and controlling the 
display on the screen. 


Console Program Console Program 


Keyboard 





Screen 


What's Happening Now What Usually Happens 


The Keyboard 


Look closely at the keyboard. You'll see that it looks much like the 
keyboard on an office typewriter. Type characters until you get to the 
end of a line, then press the RETURN key to start the next one. 





Typing 


You'll notice that the Apple III's keyboard is somewhat different from a 
typewriter's keyboard. First, the keys operate simple switches rather 
than complicated mechanisms, so you don't have to press hard on 
them. Second, the keycaps are curved and sloped for easier, more 





comfortable typing. There's also a little bump in the middle of the D 
and K keys, and one on the number 5 on the numeric keypad (to the 
right of the main keyboard). If you're a touch-typist, you'll know 
you're in the home position when you feel those little bumps with 
your middle fingers. 


The keyboard has several symbols that are not usually found on 
typewriters: 


Vertical Bar | 
Backslash \ 
Tilde ~ 
Grave Accent 
Brackets | 
Braces 1 of 
Angle Brackets < > 
Circumflex A 


These symbols are included because many programming languages 
use them. But the keyboard lacks two characters often found on 
typewriters: the cents sign and the plus-or-minus sign. 





The Keyboard 


The group of 13 keys to the right of the typewriter keyboard is called 
the numeric keypad. The keys on the keypad are grouped like those 
on an adding machine or calculator, to make it easier to enter large 
amounts of numerical data into the Apple III. The keys on the numeric 


keypad usually work the same as their main-keyboard counterparts 
(ENTER is the same as RETURN), but programs can redefine their 
meanings (as well as the meanings of most other keys) to distinguish 
them from the number keys on the main keyboard. 











Type a few zeros, using the zero keys both in the top row of the main 
keyboard and at the bottom of the numeric keypad, and look at the 
characters displayed on the screen. The slash through the zero is 
meant to distinguish it from the letter O. When the Hindus were 
inventing the number system we use, they used a symbol for zero 
which didn't interfere with any letter in their alphabet; but their zero 
happened to look the same as the Romans’ letter O. Computers (and 
clear-thinking people) want to keep them separate, so we slash our 
zeroes when they might be confused with O's. 


Similarly, if you're a typist and youre accustomed to using the 
lowercase letter | (L) for the number one, you're going to have to 
readjust. There are two keys you can use to type the number 1 : one 
on the main keyboard and one on the numeric keypad. If you use an | 
for a 1 the Apple III will get wrong information, so use a 0 for zero and 
a 1 for one. 


Besides the letter and number keys, there are some special keys on 
the keyboard. As on a typewriter, there are two SHIFT keys, one on 
either side of the keyboard. When you hold down one of the SHIFT 
keys, you change the meaning of other keys on the keyboard. 





Some keys (mostly along the top row) have two symbols on them. 
When you press the key alone, the lower character on that key 
appears on the screen. If you hold down SHIFT while pressing the 
same key, you ll get the upper character on the key. 


You've seen that when you press the letter keys on the keyboard, 
lowercase letters appear on the screen. By holding down SHIFT, you 
can type uppercase letters. Experiment with typing lowercase and 
uppercase letters and other shifted characters. Try pressing the 
ALPHA LOCK switch and typing letters and numbers: notice that it 
works like an automatic shift for letters only. 


Have you been noticing the little white square, which moves along the 
screen as you type? It's called the cursor, and it serves two purposes. 
First, it is an indication that the Apple Ill is waiting for you to type 
something. When the Apple Ill is waiting for you to type something on 
the keyboard, it usually displays a cursor. Second, the cursor 
indicates the position on the screen where the next character you 
type will be placed. Each time you press a key, the computer writes a 
character at the cursor position on the screen and moves the cursor 
to the right, like the printing element on a typewriter. 


Correcting Errors 


Nobody's perfect. If you've been typing a fair amount it’s likely that 
you have pressed a wrong key or two. You can move the cursor 
backwards to correct your mistakes; this is called backspacing, and 
the key you use is the backspace key, the left-pointing arrow in the 
lower-right corner of the keyboard. Type this line from Shakespeare's 
Sonnet 30: 


When to the sessions of sweat silent thought] 





Immediately you see you ve made a mistake. Naturally, “sweat” 
should be “sweet”. So use the backspace key to move the cursor 
back to the a. Now type ane, and the error is gone. The e replaces the 
a: this is called overstriking. 





When to the sessions of swee™ silent thought 


This is the general method of correcting typographical errors: 
backspace and overstrike. But each time you backspace over a 
character, you are actually telling the Apple Ill to forget that you ever 
typed that character. This type of backspace Is called a 
nondestructive backspace: it leaves all characters intact on the 
screen. 


lf you were to press RETURN now to begin the next line, the 
remainder of the line you typed would be erased, because by 
backspacing over it you told the Apple Ill to forget it. Before you 
press RETURN, you must move the cursor back to the end of the line. 


There are two ways to do this: you can either type the rest of the line 
yourself (not very convenient if you have to correct the first word of a 
long sentence), or you can use the right-arrow key, called the retype 

key. Each time you press this key, the cursor moves one space to the 

right. To the Apple Ill, it's as if you had typed the character under the 
cursor. Press the right-arrow key sixteen times, to move the cursor to 
the right of the word “thought”. The Apple Ill thinks you just typed “t 
silent thought”, the sixteen characters you moved over. 





When to the sessions of sweet silent thought] 





You can use this technique—backspace, overstrike, and retype to 
where you left off—whenever you detect a minor mistake in the 
middle of a line youre typing. 


But what if you type a line, then change your mind and want to delete 
the entire line and start again? You could backspace to the beginning 
and type the correct line, or you could tell the Apple III to cancel the 
entire line (everything you ve typed since you last pressed RETURN) 
by holding down the CONTROL key and typing the letter X. 


Practice cancelling lines. Press RETURN to skip to a new line and 
type the next line to Sonnet 30: 





I sigh the lack of sany a thing | sought 


Oops... this is the third line of the sonnet, not the second. To tell the 
Apple Ill to forget this line so you can start again, hold down 
CONTROL and type an X. The Apple Ill responds by typing a 
backslash, skipping a line, and waiting for you to retype the line. 


T sigh the lack of many a thing | sought’ 






The act of holding down the CONTROL key while pressing some 
other key is called typing a contro/ character. The CONTROL key 
works similarly to the SHIFT key: both keys change the meaning of 
other keys on the keyboard (however, some programs choose to 
ignore this change). The Open and Closed Apple keys can be used for 
a similar purpose: to give multiple meanings to a single key. 


Control characters do what their name implies: they control the 
operation of a program or application. Depending upon the 
application you're using, you may be asked to type many different 
control characters at various times. This and other manuals will use 
the phrase “type CONTROL-L’, for example, to mean “hold down the 
CONTROL key while typing the letter L”. 





You'll use backspacing and cancelling like this when you're using 
programs written in languages like BASIC. But some systems, such 
as Pascal, use a destructive backspace. A destructive backspace 
works just like the nondestructive backspace you've just seen, except 
that the characters you backspace over are removed from the screen. 
A language or application usually uses only one type of backspace, 
destructive or nondestructive. You can't normally change which type 
of backspace youre using, but this demonstration has a special 
command which allows you to do just that. To see how a destructive 
backspace works, hold down the Open Apple key and press the 
spacebar. 


Correctly type the second line to the sonnet: 





I Summon up remembrance of things pastll 


Now use the backspace key to go back and change “of” to “about”. 
See the characters disappear? That's destructive backspacing. Each 
character is erased as you back over it. To fix an error in a line when 
you're using destructive backspace, you must back up to the error, 
correct it, and type the rest of the line again. The retype key works 
like the spacebar when you're using destructive backspacing. Try it. 


| summon up remeabrance aboutll 





When backspacing is destructive, so is cancelling lines. Type the 
fourth line of the sonnet: 





And with old woes new wail my dear tine's waste .§ 





But these memories are unsettling: let's cancel this line. 


Type CONTROL-X (Remember how? Hold down CONTROL and type 
an X). Instead of cancelling the line as before, CONTROL-X now 
erases the entire line you typed, and leaves the cursor at the 
beginning of the same line. 


Wrapping and Scrolling 


Type the preamble to the U.S. Constitution, or any other sentence 
more than eighty characters long. When you get to the right edge of 
the screen, don't press RETURN: just keep typing and see what 
happens. Since the screen is only eighty characters wide, the whole 
sentence doesnt fit. If you were typing on a typewriter and you 
reached the right side of the page, the typewriter would probably 
stop at the right margin and stop printing characters; you'd have to 
press the carriage return to proceed. But on the Apple Ill, whenever 
the cursor gets to the right side of the screen, it automatically jumps 
to the beginning of the next line. Sometimes it splits a word in two, 
leaving the beginning on one line and the end on the next. This 
technique is called wraparound: it's as if the screen wrapped around 
behind itself so that the right edge connects to the left edge. When 
the cursor reaches the right side of the screen, its next position is the 
first character of the next line. 





Wraparound 


lf you don’t like wraparound, then you can do just as you would on a 
typewriter: when you approach the right side of the screen, press the 
RETURN key. Pressing RETURN sends the cursor to the beginning of 
the next line on the screen. In most real applications, RETURN also 
signals the Apple Ill that you've finished typing something, and that 
you want it to process what you ve typed. 














If you type enough text, or press RETURN often enough, you'll fill up 
the screen. When the cursor reaches the bottom line of the screen, 
and reaches the right edge of that line (or you press RETURN), it has 
nowhere to go: there is no ‘next line”. So the Apple Ill scro//s the 
screen, rolling it up one line, and gives you a fresh, blank line at the 
bottom. Try it: press RETURN enough times to get down to the 
bottom of the screen, type something, then press RETURN again. All 
the text rolls upwards, the top line vanishes, and a new blank line 
appears at the bottom. If you press RETURN several more times, you 
can scroll the text clear off the top of the screen. 


| heard thee speak me a speech once 
but it was never acted: or, if it 


was, not above once; for the tH 


if 
twas caviar to the general: but 
ni ‘twas Caviar to the general: bull it waa--a5 | received it. § 


[ remerber, pleased not the a1 





Scrolling: Before and After 





Try holding a key or key combination (like the exclamation point, 
SHIFT-1) down for a few seconds. The moment you press it, you get 
one exclamation point (as you expected). But after half a second, you 
start getting more and more exclamation points. It’s as if you were 
pressing that key repeatedly, 11 times per second. Every standard 
key—that is, every alphabetic, numeric, and symbol key—on the 
keyboard automatically repeats if you hold it down for more than half 
a second. 


Now without letting up on SHIFT-1, press the Closed Apple key, the 
key to the left of the spacebar. (The key to the left of the Closed 
Apple key is called the Open Apple.) Not only do you get more 
exclamation points, but they come faster, too. When you press and 
hold the Closed Apple key while holding down any other standard 
key, you will get that key repeated at a rate of about 33 keystrokes per 
second. The four arrow keys also repeat automatically at this faster 
speed if you press down firmly on them. The arrow keys act like a 
two-speed transmission, with slow and fast speeds. 





Leaving the Demonstration 





The most common uses of the console are the ones you have just 
demonstrated: typing and correcting minor errors. There's another 
demonstration on the Demonstration diskette that introduces the 
type-ahead feature. Type-ahead enables you to type information 
faster and more efficiently. You may want to experiment with that 
demonstration as well, but first you must stop the console 
demonstration you re now using. 


To leave the console demonstration and return to the demonstration 


menu, hold down the Open Apple key and press ESCAPE. Now you 
can try the typeahead demonstration, if you wish. 


The console has some other features you may wish to use. The 
operation of the console is described in full in the Apple Ill Standard 
Device Drivers Manual, which accompanies this manual. 





The Operating System 


About SOS 





The central piece of software that runs on your Apple Ill is the 
Sophisticated Operating System, called SOS (pronounced “sauce’”). 
The purpose of SOS is to provide an efficient, consistent, and flexible 
means for programs to use the hardware of the Apple Ill. All 
programs communicate with the computer's hardware and 
input/output devices through SOS and only through SOS. 


You don't interact directly with SOS: only advanced programmers 
who work in machine language will use SOS directly. But as all 
systems and languages you will be using on the Apple III themselves 
use SOS, it is important to have a basic knowledge of SOS. 


A Disk-Based System 





SOS Is included on every boot diskette you use to start up your 
Apple Ill. Because of the size, complexity, and power of SOS, it is 
possible that newer, improved versions will be released as time goes 
on. Unlike those personal computers whose operating systems are 
stored in permanent memory, the Apple Ill enables you to move up to 
a newer version of SOS easily, quickly, and inexpensively, simply by 
updating your SOS diskettes. 


Devices 





The Apple Ill communicates with the world through devices. A device 
is a part of the Apple Ill, or a piece of external equipment, that can 


transfer information into or out of the Apple Ill. Devices include the 
keyboard and screen, disk drives, and printers. 


SOS recognizes two kinds of devices: character devices and block 
devices. A character device is mainly used to get information into or 
out of the system, and a block device is mainly used to store and 
retrieve information. 


Special programs called device drivers take the streams of 
characters coming from SOS and convert them to machine actions, 
or convert physical actions of the machine into streams of characters 
for SOS to process. Device drivers for the standard Apple Ill 
peripherals are included in SOS: you can change or delete these, or 
add new ones, by using the System Configuration Program option on 
your Utilities Diskette. These operations will be explained in the 
chapter “The Utilities Diskette”. For more information on the System 
Configuration Program and device drivers, see the Apple Ill Standard 
Device Drivers Manual. 


Trying to refer to a device for which SOS has no device driver, even 
though the hardware for that device may be physically installed, will 
get you some kind of error message. Similarly, if you have a device 
driver but you don’t have the device installed in your Apple III, SOS 
cannot use it until you connect it and turn it on. 


Character Devices 


Character devices send or receive streams of characters, one ata 
time. The console (screen and keyboard), serial interface, and printer 
are all character devices. Some character devices, like the keyboard, 
are input devices: they take characters into the computer. Some, like 
the screen, are output devices: they take characters out of the 
computer. Others, like the serial interface, are input/output devices, 
and take characters in and out. 


Block Devices 


A block device is any device that stores information in blocks of 512 
characters and that can retrieve any given block on demand. All disk 
drives and other external memories are block devices. Files (except 


device files, which will be explained later) can be stored only on block 
devices. 


Device Names 


Every device that can be connected to the Apple Ill is accessible to 
SOS through its device driver, which is referenced by its device name. 
A device name is up to 15 characters long: the first is a period; the 
second is a letter; the rest can be either letters or numbers, in any 
combination. Some legal device names are 


.D1 
PRINTER 
.BLOCKDEVICE 


some illegal device names are 


PRINTER (the first character is not a period) 

-BLOCK.DEVICE (only the first character can be a 
period) 

-BLOCK DEVICE (adevice name cannot contain a 
space) 


-.BLOCK/DEVICE (adevice name cannot contain a/ ) 


In addition to its device name, a block device is accessible by its 
volume name. The volume name of a block device is the name of the 
volume currently in the device; the volume name of a floppy-disk 
drive will change as you insert and remove diskettes. A block device 
containing no volume (such as a disk drive without a diskette, or with 
an unformatted diskette, or with its door open) has no volume name 
and, to SOS, does not exist. Avolume name is up to 15 characters 
long: the first is a letter; the rest can be letters, numbers, or periods. 
Avolume name is always preceded by a slash (/ ). 


Here are a few legal volume names: 
/PROGRAMS 


/BLOCK.FILES 
/CHAP2B 


Here are some volume names that will not work, and the reasons 


why: 
/BAD NAME (contains a space) 
/1.T0.10 (first character is a number) 
/STEVE’S.PROGRAM (contains an apostrophe) 
/ANTHROPOMORPHOUS = (more than 15 characters) 
Files 





A file is anamed, orderly collection of information. Files are used to 
store, transmit, or retrieve information. Files can hold numbers, 
programs, business letters, phone lists, or any other kind of 
information you can put into your Apple III. 


All files have names. When you want access to the information stored 
in a particular file, you refer to that file by its name. 


Where to Find Files 


Files can be stored in many different places in and around your Apple 
lll. One place for a file to reside is on a block device, such as a disk. 
When a file has been stored on a disk, the information in that file is 
permanent and is not lost when the power is turned off, nor when 
you remove the disk from the Apple Ill (if the disk is removable). But 
to change the information in a file stored on a disk, you must load the 
relevant information from the file into memory, change it there, and 
then store it back onto the disk. 


Another place for a file to reside is on a character device. SOS treats 
devices such as the console (the screen and keyboard), the printer, 
and the serial port as files. To print information on a printer, for 
example, you simply write it to the device file named .PRINTER . 
Device files differ from files on block devices in two ways: all device 
file names must begin with a period, and there are some restrictions 
on how you can read from and write into device files (for example, 
you can't read from a printer). 





A file can not be stored in the Apple III's memory. The information in 
the file can be read into memory, changed there, and written out to a 
file; but the information in memory is not a file. It has no name, and it 
has no permanence: if you turn the Apple III off, the information goes 
away. 


Directory Files 


Whereas character devices are single files, block devices can contain 
dozens, perhaps hundreds, of files. To help you organize your files so 
you can easily locate a particular file when you need it, SOS allows 
you to group the files on a block device together, using directories. A 
directory is a file whose contents are the names and locations of 
other files on the volume. The directory’s name is the volume name of 
the block device it’s in. For example, when SOS looks at a diskette, all 
it sees is one file, the directory file for that diskette. To find the names 
of all of the files on a diskette, you simply look at the contents of the 
directory file. The list of the contents of a directory file is also called a 
catalog. 


Local Names 


A local name is the name of one entry in a directory: it can be a file 
containing your data, or it can be a directory file. Local names are 
composed of up to 15 letters, numbers, and periods. A local name 
must begin with a letter. The Apple III automatically converts all 
lowercase letters in a local name to uppercase. 


Here are a few legal local names: 
MIKE.2.JULY.80 
SORTPROGRAM 
LETTER.TO.SUE 


Here are some names that will not work, and the reasons why: 


BAD NAME (contains a space) 
1.T0.10 (begins with a number) 
STEVE’S.PROGRAM (contains an apostrophe) 


ANTHROPOMORPHOUS _ (more than 15 characters) 





Subdirectories and Pathnames 


At the very top level, SOS thinks that you've only got a few files: some 
device files and some directory files. That's all it sees. But each 
directory file points to some files on that block device, and any of 
those files can be a subdirectory that points to some more, and so 
on. By using directories and subdirectories properly, you can build a 
hierarchical storage system whose structure reflects the relationships 
between the pieces of information youre storing. 


For example, a diskette named PROGRAMS may contain, among 
other files and subdirectories at its top level, the subdirectory 
SORT.ROUTINES. Among the files in that subdirectory may be the file 
ALPHASORT. It may be referenced by the pathname 
/PROGRAMS/SORT.ROUTINES/ALPHASOPRT . A pathname is simply a 
volume name followed by a series of local names: the whole 
pathname is preceded by a slash, and the component names within it 
are separated by slashes. The pathname specifies the “path” that 
SOS must take to find a given file: first it reads the volume directory, 
then looks in a subdirectory for the location of the next subdirectory, 
and so on until it finds the last-named file. In this case, the directory 
of the volume PROGRAMS tells how to find the subdirectory 
SORT.ROUTINES, which tells how to find the file ALPHASORT 

(... which lived in the house that Jack built.) 


Block device names let you refer to a particular block device without 
knowing the name of the volume it contains. When SOS sees a device 
name at the beginning of a pathname, it automatically substitutes the 
name of the volume contained in the specified device for the device 
name in the pathname. The Apple Ill’s built-in disk drive has the 
device names .D1 ; the additional disk drives are named .D2, .D3 , 
and .D4 , respectively. Hence, a file named A.THRU.D in the volume 
directory of a diskette named NAMES that is in the Apple Ill’s built-in 
drive can be referred to either as 


/NAMES/A.THRU.D 
or, by using the device name, as 


.D1/A.THRU.D . 





An Example: Widgets, Incorporated 


Widgets, Incorporated, a wholly owned subsidiary of Donothing 
Gadgets Ltd., has offices in a building on Fourth Street. When you 


walk into their offices, you see three large filing cabinets against the 
wall: 


WIDGETS, INC. 





The Widgets, Inc., Filing System 


The left cabinet is labeled ACCOUNTING, the right cabinet is labeled 
PERSONNEL, and the center cabinet is labeled INVENTORY. 


The ACCOUNTING file cabinet has one drawer marked PAYABLE and 
one drawer marked RECEIVABLE. In each drawer are a lot of file 


folders, one folder for each company that has an open account with 
Widgets, Inc. 


The PERSONNEL file has drawers marked CURRENT EMPLOYEES, 
FORMER EMPLOYEES, and COMMUNICATIONS. The first two 
contain individual file folders for each current or former employee. 
The last drawer has a divider down the middle, separating INTERNAL 
from EXTERNAL communications. The INTERNAL side contains file 
folders for each person who's ever sent a memo, and each folder 
contains every memo that person has sent. The EXTERNAL side 


contains all the documentation of Widgets’ products, in no particular 
order. 


In block diagram form, this is how the files are organized: 





The Widgets, Inc., Hierarchy 


You are in charge of maintaining these file cabinets, getting things 
from them, and filing things away in them. If somebody wanted to 
write a letter of recommendation for Sam Johnson and asked you for 
Sam's personnel file, you would go to the PERSONNEL filing cabinet, 
look in the FORMER EMPLOYEES drawer, and find the file for Sam 
Johnson. If you wanted to find out how much was owed to the 
Quigley Supply Company, you would go to the ACCOUNTING cabinet 
and look in the PAYABLE drawer for the Quigley file folder. If Steve 
Atkins gave you a copy of a memo he wrote, you would go back to 
the PERSONNEL cabinet, open the COMMUNICATIONS drawer, look 
in the INTERNAL side for Steve's file, and drop the memo in with all 
of the other internal memos Steve has sent. 


(For the sake of brevity in the example, the contents of the 
INVENTORY cabinet and the other drawers in the other cabinets will 
not be discussed here.) 


lf you wanted to store all of Widgets records on the Apple Ill, you 
could set up the filing system in exactly the same way. The filing 
cabinets correspond to diskettes: 





Diskette = Filing Cabinet 


Each diskette takes the same name as the file cabinet it’s replacing: 
this name is called the vo/ume name of the diskette. The diskette's 
main, or root, directory is also identified by this volume name. So the 
ACCOUNTING diskette’s root directory would contain (in addition to 
some standard program files) the files named PAYABLE and 
RECEIVABLE , which would correspond to the drawers in the filing 
cabinet. These files themselves would be subdirectories. The 
PAYABLE subdirectory would contain files named QUIGLEY , ACME, 
and so forth, which would contain the same information that was 
previously in the individual file folders. 


The structure is the same throughout the rest of the filing system. The 
PERSONNEL diskette contains three subdirectory files: CURRENT , 
FORMER , and COMMUNICATIONS . The COMMUNICATIONS 
subdirectory contains subdirectory files called INTERNAL and 
EXTERNAL ; INTERNAL contains subdirectories for ADAMS , SMITH , 
JOHNSON, ATKINS, and all the rest of the memo senders, and finally 
the subdirectory ATKINS contains a file for each memo Steve Atkins 
has sent. 


Using Pathnames 


If you wanted to get that employee file for Sam Johnson, you would 
tell SOS how to locate that file by supplying a pathname. The 


pathname of Sam Johnson's employee file, which has the local name 
JOHNSON , is 


/PERSONNEL/FORMER/JOHNSON 


(just like PERSONNEL cabinet, FORMER drawer, JOHNSON file). The 
pathname for the Quigley accounts payable file is 


/ACCOUNTING/PAYABLE/QUIGLEY 


and the name of the individual memo that Steve Atkins sent on March 
15 might be 


/PERSONNEL/COMMUNICATIONS/INTERNAL/ATKINS/ 
MARCH.15 


Personnel _ 





/PERSONNEL/FORMER/JOHNSON 


(The period is in MARCH.15 because a pathname cannot contain a 
space.) 


If the volume PERSONNEL is in .D2 , this pathname could be written 
.D2/FORMER/JOHNSON , using the block device named .D2 . Each 
file has one pathname, and each pathname specifies only one file. 
Even if you have two files with the same local name, such as 
accounts payable to and receivable from Quigley, you can still tell 
them apart by their pathhames. One would be named 


/ACCOUNTS/PAYABLE/QUIGLEY 


and the other would be 
/ACCOUNTS/RECEIVABLE/QUIGLEY 


Even though the two files have the same local name, they are 
different because they have different pathnames. 


The Prefix and Partial Pathhnames 


It would be inconvenient to have to specify a complete pathname 
whenever you wish to locate a file. For example, if you wanted to look 
at all the memos Steve Atkins has sent, you wouldn't want to have to 
type the entire forty- or fifty-character pathname of each memo. SOS 
avoids this problem by means of a stored pathname called the prefix. 
The prefix is a pathname that specifies a directory or subdirectory. 
Once you have set the prefix, you can refer to any file in the prefix 
directory by its local name alone. So if you were reading Steve Atkins’ 
memos, you would set the prefix to 


/PERSONNEL/COMMUNICATIONS/INTERNAL/ATKINS 


and refer to the individual memos by their local names: MARCH.15 , 
PURCHASEPLAN , RELEASESCHED , and so forth. Setting the prefix 
is like bringing just one drawer from the filing cabinet over to your 
desk: you know you wont need the contents of all three cabinets at 
your fingertips, only the files in the drawer you have. 


You can set the prefix to the pathname of any directory or 
subdirectory, as explained in the section “set Prefix” in the chapter 
on the Filer. Individual application programs and languages have 
other ways of setting the prefix, which are explained in their 
respective manuals. If the prefixed directory has subdirectories, you 
locate the files in the subdirectories by using partial pathnames. A 
partial pathname is the pathname from the prefix directory to a given 
file. If you were going to be looking at all the employee files, both 
current and former, you might set the prefix to /PERSONNEL ; you 
could then refer to current employee George Simpson's file by the 
partial pathname 


CURRENT/SIMPSON 


and former employee Sam Johnson's file by the partial pathname 
FORMER/JOHNSON 


Even when you set the prefix, you can still get to any other file in the 
system by supplying its full pathname. The prefix is only used when 
you supply a pathname that does not begin with a slash or period. 
(Thus pathnames that begin with device names will never have the 
prefix applied by SOS.) If you set the prefix to /ACCOUNTING , you 
can still locate a memo you sent about the Quigley account by the full 
pathname 


/PERSONNEL/COMMUNICATIONS/INTERNAL/ 
YOURNAME/QUIGLEYMEMO 


without changing the prefix. You can also locate the Quigley 
receivable file by the partial pathname 


RECEIVABLE/QUIGLEY 


and use the account auditing and balancing program (stored 
in the directory /ACCOUNTING ) with the local name 


AUDIT.BALANCE 
all without changing the prefix. 


When you boot SOS, the prefix is automatically set to the 
volume name of the boot diskette. 


Using Files 





Among the standard operations you can perform on disk files are 
reading information from them into memory, storing information from 
memory into them, creating new files and destroying old ones, 
changing their names, and setting some other miscellaneous 
information about them. You can also set the prefix and find out what 
the current prefix is. 


Languages and applications on the Apple III will have slightly 
different names for each of these procedures, and slightly different 
ways of using them; the manuals for the language or application 
you're using will describe exactly how to perform the file 
manipulations. But a file is a file is a file, and directory files are 
directory files whatever you're doing on your Apple Ill. 


You'll also see other types of files. Besides directory files, there are 
program files, data files, random-access files, and sequential-access 
files, but they're still all files and they're all manipulated in the same 
ways. 


Also, don't let the complexity of the Widget company’s files scare you. 
You'll rarely build hierarchies of such complexity on the Apple Ill. If 
you are using diskettes, you might have different diskettes for 
different purposes, and maybe a few subdirectories on each diskette, 
but you'll find that you usually won't need more than one or two 
levels of subdirectories on any one diskette. The important thing is 
that the capability is there. If you acquire a disk drive with more 
capacity sometime in the future, you'll want to use the full power of 
pathnames and prefixes. 








The Utilities Diskette 


Now find the diskette labeled APPLE III SYSTEM UTILITIES, insert it 
in the built-in disk drive, and boot it by turning on the power or 
pressing CONTROL-RESET. 


The Utilities diskette does three things: 


¢ Operations on devices, such as formatting volumes to hold 
data and copying the contents of one volume onto another. 


e Operations on files, such as transferring, deleting, and 
renaming. 


e Configuring the operating system so that it knows what 
devices are connected to your Apple Ill, and has the device 
drivers to handle them. 


This chapter will tell you how to back up your diskettes, how to 
configure your system, and how to format blank diskettes. The next 
chapter will explain operations on files and devices. 


When you boot the Utilities diskette, the first thing you see on your 
screen is the Utilities Diskette Main Menu: 


le /// Wealities = Maan Renu lersion 1.1 
(S28, 1581 beole Computer All Rights Peserved 
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F = File handling commands 
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Utilities Diskette Main Menu 


This menu works much like the menu on the Demonstration diskette: 
to perform one of the functions listed on the menu, you type the 
letter associated with that function. 


Backing Up the Utilities Diskette 





The next thing you need to know is how to make a backup copy of a 
volume. It Is very important to make at least one backup copy of 
every volume containing valuable software or information. For this 
you will use the Copy-volume command, so called because it copies 
information a whole volume at a time. The Copy-volume command 
will use two volumes: a source volume, which is the volume 
containing the information to be copied, and a destination volume, 
which is the volume onto which the original information will be 
copied. 


You can use almost any volume for the destination volume: the Copy- 
volume command can copy onto formatted blank volumes, 
unformatted volumes, or volumes that already have information on 
them. The two volumes and their respective devices must be of the 
same kind: a Disk II! and a Disk II for the Apple Ill are of the same 
kind; a Disk II! and a rigid (hard) disk are not. For copying between 





volumes of different kinds, see the Copy-files command in the 
chapter “The Filer.” 


The Copy-volume command makes an exact copy of the source 
volume on the destination volume; any information previously on the 
destination volume will be lost. If you attempt to copy onto a volume 
that already contains some information, the Copy-volume command 
will ask you to verify that you do indeed want to destroy the previous 
contents of that volume. 


To make a copy of a volume, choose option 
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Device Handling Commands Menu 
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Utilities Diskette Device Menu 


Then choose option 





from the Device Menu, to get this screen: 





Copy one volume onto another 


For now, let’s make a backup copy of the Utilities diskette itself. You'll 
need two diskettes: the Utilities diskette and one blank diskette. As 
the Copy-volume command works with two volumes, it’s helpful to 
have two disk drives. If you have only the built-in disk drive, you can 
still make copies, but you have to swap the diskettes in and out of the 
one drive. See the section “Copying with One Drive’, below. 


Write-Protection 


Compare the Utilities diskette and a blank diskette. You will notice 
that the blank diskette has a notch on its right side, and the Utilities 
diskette does not. This notch tells the Apple III that it is OK to write on 
the diskette. The Utilities diskette, which has no notch, is write- 
protected: you cant write on it. Most Apple software is distributed on 
write-protected diskettes, to protect the software from getting erased 
accidentally. 


You can protect your own software and data, too. With blank 
diskettes you get a sheet of silver write-protect tabs. (They look like 
stick-on labels, but they're not—try writing on one.) If you cover the 
notch on a diskette with a write-protect tab (just fold it over the edge 
of the black diskette cover, one end on each face), the diskette will be 
write-protected. 


Copying With Two Drives 


The first, highlighted, field 






asks you for the name of the device you are going to put the source 
volume in, and offers you a default, which you will not use, since the 
Utilities Diskette, the source volume, is already in the built in drive, 

.D1 . (If the Utilities diskette isn't already in the built-in disk drive, put 
it there now and close the drive door.) Then type .D1 (the device name 
for the built-in drive) and press RETURN. (Of course, if your source 
volume were in some other device, you would type the name of that 
device instead, or use the default if appropriate.) 


> If you mistype an input, backspace with the left-arrow 
key and type over your mistake. 


The highlight will now be on this field: 





Note that the default changed in response to your first input. We'll 
use drive 2, the first external disk drive, as the destination device. 
Insert the destination volume into drive 2, then press RETURN to 
accept the default. 


The next field, 





lets you give the copy a different name from the original, which is 
handy if you might have to use the two volumes at the same time. We 
won't, so just press RETURN. 


Now press RETURN again to make the copy. The Copy-volume 
command has a safety feature to prevent you from inadvertently 
destroying valuable information. If the volume you insert in the 
destination disk drive is not blank, the copy program will ask 





using whatever volume name it finds already stored on the 
destination volume. If you have inserted the wrong volume or made 
some other mistake, you can safely cancel the copy operation, 
without destroying any information, by typing N (for “No’”). If you 
really intend to destroy the previous information on the destination 
volume, type Y (for “Yes”). 


When the copy is done, the Copy-volume Screen, with the fields as 
you left them, will be displayed. To make another copy of the Utilities 
Diskette, you need only insert another diskette in .D2 and press 
RETURN three times to accept the defaults. To go to the Device 
Menu, press ESCAPE. To go to the Main Menu, press ESCAPE again. 
You will notice that the ESCAPE key has a certain consistency of use. 
In general, it means “Return to the previous step or state.” 


Copying With One Drive 


The procedure for copying volumes with only the built-in disk drive is 
much the same as the procedure for copying with two drives 
(explained above), except that you must repeatedly swap the source 
and destination volumes in and out of the single drive. The number of 
such swaps will depend on the amount of memory you have in your 
Apple Il. 


The first, highlighted, field on the copy menu 





asks you for the name of the device you are going to put the source 
volume in, and offers you a default, which you will not use because 
you don't have an external drive. (.D2 is the default because the 
system thinks you have two drives until you use the System 
Configuration Program—explained in the next section.) The source 





volume in this case is the Utilities diskette itself. If the Utilities 
Diskette isn't already in the built-in disk drive, put it there now and 
close the drive door. Then type .D1 (the device name for the built-in 
drive) and press RETURN. 


The highlight will now be on this field: 





Insert the destination volume into the built-in drive, then type .D1 and 
press RETURN. 


The next field, 





lets you give the copy a different name from the original, which is 
handy if you might have to use the two volumes at the same time. We 
won't, so just press RETURN. 


The Copy-volume command has a safety feature to prevent you from 
inadvertently destroying valuable information. If the volume you 
insert in the destination disk drive is not blank, the copy program will 
ask 
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using whatever volume name it finds already stored on the 
destination volume. If you have inserted the wrong volume or made 
some other mistake, you can safely cancel the copy operation, 
without destroying any information, by typing N (for “No’”). If you 
really intend to destroy the previous information on the destination 
volume, type Y (for “Yes”). 


The Apple III will now store all the information it loaded into its 
memory onto the destination volume. It will then ask you to insert the 


source volume again. Open the door, remove the destination volume, 
and insert the source volume. Close the door and press RETURN. 
Repeat this procedure until you see the message 





The program keeps track of which diskette is in the drive, so you 
needn't fear that you will forget whether you need to swap or not if, 
say, someone interrupts you while you are copying. 


When the copy is done, the Copy-volume Screen, with the fields as 
you left them, will be displayed. To make another copy of the Utilities 
Diskette, you need only insert another diskette in the built-in drive 
and press RETURN three times to accept all the defaults. To go to the 
Device Menu, press ESCAPE. To go to the Main Menu, press ESCAPE 
again. You will notice that the ESCAPE key has a certain consistency 
of use. In general, it means “Return to the previous step or state.” 


Configuring Your System 





The third option on the Utilities menu, the System Configuration 
Program (SCP), is used to tailor the system software on your boot 
diskettes to match the specific number and types of input and output 
devices connected to your Apple Ill. This process is called 
configuring your boot diskettes. 


Every time you boot your Apple Ill, asystem configuration is loaded 
into memory from the boot diskette. The system configuration 
includes a collection of special programs called device drivers, which 
enable the Apple Ill to communicate with input/output devices 
connected to it. Each type of input/output device has its own driver, 
designed specifically for that device. If the system configuration on 
the boot diskette doesn't contain a driver for a particular device, the 
Apple Ill will be unable to communicate with that device. 


In addition to device drivers, the system configuration also includes 
certain special pieces of information called system parameters, such 
as the number of Disk III floppy disk drives connected to your 

Apple Ill, the keyboard layout, and the character set to be used for 
displaying text on the screen. 





The Apple III's built-in input/output devices are controlled by standard 
device drivers. The boot diskettes supplied with your Apple Ill come 
preconfigured with some of these standard drivers. (Because of 
memory and disk space limitations, not every boot diskette contains 
all of the standard drivers.) The standard device drivers include the 
console driver, for communicating with the Apple III keyboard and 
displaying text on the screen; the graphics driver, for displaying 
graphics on the screen; the printer driver, for communicating with a 
printer through the Apple Ill's built-in serial interface port; the audio 
driver, for generating sounds on the Apple IIl’s tone generator; the 
RS-232 driver, for communicating with a serial device; and the 
Silentype driver, for communicating with the Silentype printer. For 
complete information on the Silentype driver, see the Si/entype 
Manual, for information on the standard drivers, see your Apple /// 
Standard Device Drivers Manual. 


In addition to the standard drivers, there is also a driver for each 
peripheral device you can connect to your Apple Ill. The driver is 
provided on a diskette accompanying the device, and is described in 
the manual supplied with the device. 


Complete information on the System Configuration Program can be 
found in the chapter The System Configuration Program in the 
Standard Device Drivers Manual. There you can learn how to 


e build asystem configuration containing the drivers you need 
for your particular collection of peripheral devices, 


e change asystem configuration by adding or deleting device 
drivers, or 


® change the system's standard character set or keyboard 
layout. 


For now, we will just use the System Configuration Program to set up 
your boot diskettes for the correct number of Disk III floppy disk 
drives connected to your Apple Ill. If you have one external drive, your 
system will already operate correctly. However, you will find it useful 
to go through the following procedure with one of your diskettes, so 
that you will understand the procedure. 


Using the System Configuration Program 


To use the System Configuration Program, boot the Utilities diskette 
(if you haven't done so already) and choose the option 








from the Main Menu by typing the letter S . After a delay, the 
Configuration Menu will will appear on your screen: 
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Configuration Menu 


At the bottom of the screen is the message 





The first step is to read the current system configuration into memory 
from one of your boot diskettes. Select the option 





from the Configuration Menu by typing the letter R . A new display 
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Read a Driver File 


will replace the Configuration Menu on your screen. The area near 
the top of the screen headed 


Current Driver Configuration: 





is used by SCP to display a list of the device drivers in the system 


configuration you are building in the Apple III's memory. Since you 


havent yet added any drivers, this area currently contains the 
message 


Ho Qrivers are loaded. 





About halfway down the screen is a line reading 


{ Available memory: Approximately 25K bytes ) 





(The number above will vary with your configuration.) 


As you build a system configuration, this line always tells you how 
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much memory space you have left in which to store additional device 


drivers. The number you see on this line when the configuration is 


empty depends on the amount of memory you have in your Apple Ill. 





At the bottom of the screen is the message 





The Apple III is waiting for you to supply the name of a disk file 
containing one or more device drivers. 


You are going to load the current system configuration from one of 
your boot diskettes. You might as well use the Utilities diskette itself, 
since it is already in your built-in disk drive. The system configuration 
on a boot diskette is always stored in a file named SOS.DRIVER , so 
that is the file you should load: type the pathname .D1/SOS.DRIVER 
and press RETURN. 


The disk drive will whir for a while as the contents of the file are 
loaded into memory. Then the names of the device drivers contained 
in the file will appear in a list at the top of the screen, and the 
program will ask for another filename. (The drivers named .FMTD1 , 
.FMTD2 , .FMTD3 , and .FMTD4 that you see listed in the Utilities 
diskette’s system configuration are special drivers used for formatting 
diskettes. The plus signs mean that these four drivers are grouped 
together into a driver module. See READING A DEVICE DRIVER in 
Chapter 2 of your Standard Device Drivers Manual for more 
information on driver modules.) 


Since you don't want to load another file, just press ESCAPE to 
display the Configuration Menu again. 


Changing the System Parameters 


Now you are going to look at the system parameters in the system 
configuration you have just loaded, and change them If necessary to 
reflect the number of Disk III floppy disk drives connected to your 
Apple Ill. Select the option 


L - Change systes Parameters 





from the Configuration Menu by typing the letter C . A new display 
replaces the Configuration Menu on your screen. At the top of the 
screen are the current values of the system parameters, which you 
have just loaded from the system configuration on your Utilities 
diskette. At the bottom is the message 





Look at the second line under CURRENT SYSTEM PARAMETERS at 
the top of the screen. If you are using a brand-new Utilities diskette, 
or a copy of one, it should read 





Type the number 1 (the number of the parameter you wish to 
change). The last line of text on the screen will change to read 
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Type the number of Disk III drives connected to your Apple Ill (1, for 
example, if you have only the Apple III's built-in drive) and press 
RETURN. You will see the value of the parameter change at the top of 
the screen, and SCP will again ask you for the number of a parameter 
you wish to change. For now, just press ESCAPE to return to the 
Configuration Menu. (System parameters other than the number of 
disk drives are discussed in the chapter The System Configuration 
Program in the Apple /// Standard Device Drivers Manual.) |\f you 
have two drives, you can skip this step. We have led you through it so 
that you will know how. 


Generating a New System 


Now that you have built a new system configuration in the Apple Ill’s 
memory, with the correct value for the “Number of Disk III Drives” 
parameter, you must store this configuration back onto the Utilities 
diskette. Then the new configuration will take effect the next time you 
boot the Apple Ill from that diskette. Choose the option 





from the Configuration Menu by typing the letter G . The 
Configuration Menu will be replaced on your screen by the message 





This means that SCP is checking the configuration you've built for 

internal consistency (it doesn't guarantee that your Apple II! will be 
able to operate in that configuration). If all is well, you will soon see 
the message 





SCP now asks you for the name of the diskette file in which the new 
configuration is to be stored: 





q") In order for the new system configuration to be 
loaded when you boot the diskette, you must store the 
configuration into a file named SOS.DRIVER . But be 
careful! If you store a file named SOS.DRIVER on one 
of your important boot diskettes, it will destroy the 
configuration that was formerly on that diskette. If for 
any reason the new configuration is not usable, THAT 
BOOT DISKETTE WILL NOT BE BOOTABLE until you 
recreate a proper configuration and store it onto that 
diskette. 


Dont take chances with your valuable boot diskettes! 
Whenever you build a new system configuration, store 
it first onto a backup copy of the boot diskette and try 
booting it. Then, if anything goes wrong with the new 
configuration, you will still have your original working 
copy of the boot diskette intact. 


SCP is still waiting for the name of a file in which to store the new 
system configuration you have built. Remove your working copy of 


the Utilities diskette from the built-in disk drive and insert the backup 
copy of the Utilities diskette that you made earlier with the bulk copy 
utility. Then type 


.D1/SOS.DRIVER 


and press RETURN. 


Do not leave your working copy in the built-in drive 


and insert the backup in one of the external drives. 
Never load two diskette volumes with the same 
volume name at the same time. 


When you try to store the new configuration on your backup Utilities 
diskette, you will get the following prompt: 





You want to delete the old SOS.DRIVER file and replace it with the 
new one you have just made, so type Y. If all goes well, the disk drive 
will whir for a while as it writes the new system configuration on your 
backup Utilities diskette. As soon as the operation is completed, you 
should immediately try booting the diskette. 


If the new configuration does not work properly, boot your original 
Utilities diskette and choose option S (System Configuration 
Program). From the SCP menu, use option R (Read a Driver File) to 
load the new configuration from your backup Utilities diskette, and 
make any necessary changes to the configuration. Generate the new 
configuration and save it onto the backup diskette, then boot the 
diskette to see if the new configuration works. If it doesn't, you'll have 
to boot the original Utilities diskette again and change the 
configuration so that it works. You shouldn't have this kind of 
problem, as you are only changing the number of disk drives the 
system thinks it has: even if you set the wrong number, you should 
still be able to boot, although you may not be able to use all your 
drives. 


Now load the configuration from another boot diskette, and use the 
process described above, beginning with the section USING THE 
SYSTEM CONFIGURATION PROGRAM, to check, modify, verify, and 
save the new system configuration on your boot diskette. Repeat the 
process for every boot diskette you have. When you ve finished 
configuring all your boot diskettes, choose option Q (Quit) to return 
to the main menu. 


The System Configuration Program has other capabilities besides the 
ones discussed here. The Standard Device Drivers Manual and the 
manuals for Apple products that use the System Configuration 
Program contain instructions on using those capabilities. 


The SOS Diskette Request 


Now try an experiment. Return to the Configuration Menu, and 
remove the Utilities diskette from the built-in drive. Now type Q (Quit) 
and see what happens. You will get a beep, and this message: 
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The SOS Diskette Request 


After you insert the Utilities diskette and press the ALPHA LOCK key 
twice, the Main Menu will reappear on the screen. What just 
happened is this: when you pressed ESCAPE for the second time, the 
Apple Ill tried to read part of the Utilities program from the Utilities 
diskette. When it failed to find the diskette, it asked you to put it in, 
and waited for you to do so and confirm that you had. Any time SOS 


cannot find the diskette it expected to find in a given drive, you will 
get this message. If the needed diskette had never been in the 
system, you will not get this message, although you may get a 
message from the program, telling you to put it in. 


The reason that SOS asks you to press the ALPHA LOCK key (rather 
than RETURN, say) is that ALPHA LOCK does not type a character: 
so if you had typed ahead, no spurious character would be added to 
your input. 


Formatting Blank Diskettes 





Your Apple IIl comes supplied with some blank floppy diskettes. (You 
can buy more from your Apple dealer.) You'll use these diskettes to 
store information and programs you generate while using Apple Ill 
languages or applications. But before your Apple Ill can store any 
information on a diskette, you must first format the diskette. 


The Format-a-volume command on the Apple Ill Utilities diskette 
invokes the formatting program, which is designed for use with many 
kinds of mass-storage media, including larger floppies and rigid 
disks as well as floppy diskettes. So instead of just talking about 
diskettes, we will use the more general term vo/ume, which refers to 
any form of mass-storage medium. 


When a volume of magnetic mass storage (such as a diskette) is 
manufactured, it contains no information at all: it’s like blank 
recording tape. Formatting the volume prepares it for use by dividing 
up its recording surface into standard-size blocks where information 
can later be stored. 


ep You can reformat a volume that isn't blank, but 
reformatting will erase its old contents. 


When you format a volume, you also give it avo/ume name by which 
you can refer to it later. You can choose any name you wish, subject 
to the rules for local names given under Local Names in the chapter 
The Operating System. You can also let the formatting program 
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assign it a unique name, which is handy if you haven't decided what 
to put on the diskette. 


To format a volume, first choose the option 





option 





from the Device Menu by typing the letter F. You will get this screen: 





Format a volume 


This is a fill-in screen, with two blanks, or fie/ds, to fill in. The first, 


= the sediue of VOLUME © 


is highlighted (black on white). The first thing you have to tell the 
formatting program is which device (normally a Disk III floppy-disk 
drive) you're going to use to format the blank volume. The program 
has already filled in the field for you, guessing at what you'll type. 
This guess is called the default, because it will be used by default if 
you like it. If you press RETURN, the field's contents will be accepted 
as is; if you type anything, it will replace the default. 








If you don't have any additional drives, you'll have to use the 

Apple Ill’s built-in drive. Its device name is .D1 (for Disk 1). Open the 
door to the disk drive, remove the Utilities diskette from the drive. 
Insert the volume you wish to format. Type .D1 and press RETURN. 


If you have one or more external disk drives connected to your 

Apple Ill, you might want to use one of them, to avoid having to 
remove the Utilities diskette from the built-in drive. The additional 
drives are named .D2 , .D3 , and .D4 , for the second, third, and fourth 
disk drives, respectively. 


Storage devices other than floppy diskette drives will have different 
device names, as specified in the manual accompanying the device. 
For now, use the first additional drive: insert the diskette into .D2 and 
press RETURN. 


Whichever device you choose, the highlight will move on to the next 
field 





choosing a random name for it. If you have a name in mind for the 
diskette, type it and press RETURN. 


So We strongly recommend that you use a different name 


for each volume you format. If your Apple Ill is 
equipped with one or more external disk drives, it is 
particularly important never to load two volumes with 
the same name at the same time. Having two volumes 
with the same name makes it possible for the 
computer to write information onto one of them ina 
location where it actually belongs on the other. If this 
location already contains some other information, the 
information will be destroyed. 


lf you wish the formatting program to assign a name, press RETURN 
without typing anything: the diskette will be given a name from 

BLANKOO to BLANK9Q9. Each time you run the formatting program, it 
picks a random starting number for the last two digits of the diskette 


name, and numbers further diskettes in sequence from that number; 
if the numbers go past 99, it starts over with OO. This feature lets you 
format a whole box of diskettes in a few minutes, without having to 
worry about calling any of them by the same name. 


lf the volume you insert is not blank, the formatting program will now 
ask 





using whatever volume name it finds already stored on the volume. 
This is a safety feature to prevent you from inadvertently destroying 
valuable information. If you have inserted the wrong volume or made 
some other mistake, you can safely cancel the formatting operation, 
without destroying any information, by typing N (for No). If you really 
intend to destroy the previous information on the volume you ve 
inserted, type Y (for Yes). 


It is very easy to get into the habit of answering Y 


whenever you see a message like 


Do you wish to destroy volume “BLANK23" (Y/N) ? 


For this reason, it is wise to use the default names 
BLANKOO to BLANK9Y9 for blank diskettes, and to 
rename any diskette that is no longer blank. 


After you type Y, the Apple III will make a short rattling sound, then 
whir and zick for a while as it formats the volume. When it's finished, 
it will display 





Remove the volume from the disk drive, write the volume name you 
have just given it on the label, place it back in its protective paper 
envelope, and store it in a safe place. The program is now at the 
beginning of the formatting sequence so you can format more 
volumes. 


It's a good idea to format all your blank diskettes now 


and to make sure you always have a supply of 
formatted diskettes on hand. Suppose you were using 
some language or application on the Apple Ill and had 
entered a lot of information into the computer. If you 
discovered that all your diskettes were full and could 
hold no more information, you'd be stuck. You would 
have no place to save the information stored in the 
computer's memory, and no way to format a fresh 
diskette without losing the contents of memory. So 
every time you get some new, blank diskettes, format 
them immediately so that they will be ready to use 
when you need them. 


When you have no more volumes to format, press ESCAPE to return 
to the Device Menu, then go to the next section. 


oy lf something goes wrong during the formatting 


process, the formatting program will display an error 
message informing you of what went wrong. If you 
get one of these messages, refer to Appendix A of this 
Owner's Guide. 


We hope that the experience of using both the console demonstration 
and the Utilities Diskette have made you familiar with the Apple III 
and the way it works. The next chapter will show you other features 
of the Utilities diskette. 





When you formatted and copied diskettes earlier, you used a program 
called the Filer, on the Utilities Diskette. In that case you performed 
both operations on input/output devices. More such device 
operations will be explained later in this chapter. Now you will learn 
how to do a few things with files. First, boot the Utilities Diskette. 
With the Main Menu on the screen, type F (File Handling Commands 
Menu). You will get this menu: 
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File Menu 


The menu lists the operations that the Filer can perform on Files: 
these will be explained as you read on. 





Reading a Directory 


With the File Menu on the screen, type L (List files) and respond to 
the prompt by typing .D1 followed by three RETURNs. Now you will 
see the Utilities diskette's directory listing (catalog) on the screen. At 
the top is the volume name of the diskette, followed by a set of 
headings. Below is a list of the files on the diskette, each followed by 
some information about it: its size in blocks of 512 characters, the 
date and time it was last changed, its type, and a few numbers that 
you don't have to bother with for now. (They will be explained in the 
Apple Iii SOS Reference Manual.) 


Using the Filer 





Now let's use some of the commands to make a/PERSONNEL 
diskette for the Widget Company. First format a diskette, and name it 
/PERSONNEL. List its directory by typing F L/PERSONNEL (without 
Spaces) and pressing RETURN three times. After the menus and 
screens go away, you will see this: 
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/PERSONNEL directory 


Now we're going to make some files. First we need to make some 





subdirectories. Get the File Menu up on the screen, and type M 
(Make). You will see 
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Make a subdirectory 


First you type the pathname of the subdirectory, /PERSONNEL 
CURRENT, and press RETURN. Now you are asked how many files 
you need room for in your subdirectory. The default, 25, ought to be 
enough, so press RETURN. (You can type any number you like: in 
some cases SOS will allocate more.) When you List the directory of 
/PERSONNEL, you will have a subdirectory called CURRENT, 
occupying 2 blocks. 


Now create subdirectories named FORMER, COMMUNICATIONS, 
INTERNAL, and EXTERNAL. 


The first column of your directory will look like this: 
/PERSONNEL 
CURRENT 
FORMER 
COMMUNICATIONS 
INTERNAL 
EXTERNAL 


Now we have a problem: INTERNAL and EXTERNAL are 
subdirectories under COMMUNICATIONS. We can move them where 
they belong with the Copy command. Type C (Copy) from the File 
Menu. You will get this screen: 


beple /// Weilities 7 Aug 81 sees 
Copy Files Command Prefix is “UTILITIES 
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Copy files 


lf you press RETURN to all the defaults, the Filer will copy the file 
EXTERNAL from the diskette /PERSONNEL to another diskette. This 
is not what we want—we want to copy it to a different place on the 
same diskette, and we want to copy INTERNAL first—so type 
/PERSONNEL/INTERNAL for the source file pattern (the only file 
pattern we know about now Is a pathname: we will learn about others 
later in the chapter). Press RETURN. Now type 
/PERSONNEL/COMMUNICATIONS/INTERNAL for the destination file 
pattern. Press RETURN. When the whirring stops, list the catalog: 


/PERSONNEL 
CURRENT 
FORMER 
COMMUNICATIONS 

INTERNAL 
INTERNAL 
EXTERNAL 


The local name INTERNAL appears in two places: as a subdirectory 
to /PERSONNEL, and as a subdirectory to the subdirectory 
COMMUNICATIONS. The indentation of the directory will make this 
clear: each subdirectory or file is indented under the directory that 
holds it. We'll get rid of the extra copy in a minute. 


Now copy EXTERNAL under COMMUNICATIONS. The source file 


pattern is /PERSONNEL/EXTERNAL. The destination file pattern is 


/PERSONNEL/COMMUNICATIONS/EXTERNAL. Now you will have 
this catalog: 


[PERSONNEL 
CURRENT 
FORMER 
COMMUNICATIONS 

INTERNAL 

EXTERNAL 
INTERNAL 
EXTERNAL 


This is OK, except for the extra copies of INTERNAL and EXTERNAL. 
We'll get rid of them with the Delete-files command. Type D (Delete) 
from the File Menu to get this screen: 





Delete files 


Type /PERSONNEL/INTERNAL, then press RETURN. You will be asked 
to confirm the deletion: type Y (for Yes). After you confirm the 
deletion, the file /PERSONNEL/INTERNAL will be deleted: that is, 


removed from the directory it is in. Every operation that could destroy 
data will require confirmation. 


Now Type D (Delete) again, then type the file pattern 





/PERSONNEL/EXTERNAL and press RETURN. Confirm the deletion 
with a Y (Yes). Now list the catalog: 


/PERSONNEL 
CURRENT 
FORMER 
COMMUNICATIONS 

INTERNAL 
EXTERNAL 


We could have avoided the deletion, by making the files in the right 
place in the subdirectory structure, but this roundabout procedure 
lets us show the Delete-files command. 


We now have the skeleton of the Widget company’s personnel files. 
By making a subdirectory 
/PERSONNEL/COMMUNICATIONS/INTERNAL/ATKINS , we can 


reproduce the subdirectory structure described in the previous 
section: 


/PERSONNEL 
CURRENT 
FORMER 
COMMUNICATIONS 

INTERNAL 
ATKINS 
EXTERNAL 


We can't reproduce the full hierarchy, 


/PERSONNEL 
CURRENT 
SIMPSON 
FORMER 
JOHNSON 
COMMUNICATIONS 
INTERNAL 
ATKINS 
MARCH.15 
EXTERNAL 





because SIMPSON, JOHNSON, and MARCH.15 are not subdirectory 
files: they are data files, text files, or some other kind of files. The 
Filer can only make subdirectory files because it cannot produce the 
contents of other kinds of files. It’s like a filing clerk, who can move 
file folders from drawer to drawer, but doesn't write the letters and 
memos inside them. 


Text-editors create text files, language compilers create code files, 
accounting programs create data files, and so forth; but the Filer 
cannot create these kinds of files or change their contents. The Filer 
is useful for rearranging files created by other programs in forms 
convenient for you. This will be especially true if you eventually get a 
mass-storage device larger than a Disk Ill. Then you will find yourself 
copying a whole diskette to a subdirectory on the larger device, and 
moving files from one subdirectory to another on that device. 


Operations On Files 





In the preceding section, we have tried out a few of the Filer's file- 
handling commands. In this section, we will examine them all. When 
you type F (File handling commands) from the Main Menu, you will 
get this menu: 





File Menu 





You select a command option by typing the letter before it. As soon 
as you type the letter, the screen for that command appears. You can 
return to the Main Menu by pressing ESCAPE. 


Note that each command option line in the File Menu 


has one, and only one, capital letter: that is the letter 
you type to execute that command. In this chapter, 
every section named for a command will reproduce 
this spelling quirk faithfully, as an aid to memory and 


understanding. 


List files 


The List-files command shows the directory listing (catalog) of a 
volume or subdirectory. Here is the catalog of the Widget company’s 


/PERSONNEL diskette. 
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sending the listing to the File 





/PERSONNEL Catalog 


The volume name appears across the top, followed by headers. Each 
file is listed on a separate line, its name followed by 


Size: the number of blocks taken up by actual data 
Modification Date: the date the file was last changed 
Time: the time the data was last changed, if time was set 
File Type: this can be 

Data: binary data 

PasText: a file of characters, with certain formatting data 

PasCode: a machine-language program file 

BASICProg: a BASIC program file 

ASCII: a file of characters, without formatting data 

Directory: a subdirectory file 

Font: a character-set file 

Foto: a screen-image file 


EOF: the number of characters that can be read from the last 
block in the file 


Physical Size: the number of blocks physically occupied by the 
file 


The relationship between Size, EOF, and Physical Size is fairly 
complex, and need not concern us here. It is explained in detail in the 
SOS Reference Manual. You will mostly be concerned with the 
pathname, the size, the modification date, and the file type. 


To list the catalog of a directory—either volume or subdirectory— 
type L (List files) from the File Menu to get this screen: 





List the catalog entries of files 


The screen presents a series of fields to fill in, the topmost field 
highlighted. Each field is a question you must answer: it contains a 
default response, which is the program's guess as to your probable 
answer. If the program guessed correctly, you can accept the default 
in the highlighted field by pressing RETURN. If not, type the correct 
response. If you wish to change your response, move the cursor back 
with the left-arrow key and type over. When you are satisfied, press 
RETURN to accept the current field’s contents and move to the next 
field. You can back up to the previous field by pressing CONTROL- 
RETURN. 


In the List-files command, the highlight will be on the first field, 


the directory information of the files: 





At this point, you can return to the File Menu by pressing ESCAPE. 
You may now type a file pattern, described in the next section. In the 
List-files command, the file pattern is often the pathname of the 
directory whose files you want to list. The default is the last pathname 
typed. 





The next field asks you how many directory levels you want listed. If 
you type 1, only the directories and files immediately below the 
pathname you typed will be listed. 


The final field specifies the file to which you want to send the listing. 
Usually, it's the screen, so you use the default .CONSOLE . You can 
also list to a disk file (like .D2/LIST.TEXT) or a Qume ( .PRINTER ) or 
Ssilentype ( .SILENTYPE ) printer, if you have one. 


While typing into a field, you can change your mind and restore its 
previous contents by pressing ESCAPE. 


Once you have filled in the last field as you wish, press RETURN, and 
the catalog will be listed. After the command has been executed, the 
cursor will hop to the top of the screen: ESCAPE will return you to 
the File Menu. Otherwise, you may execute the command as before: 
the defaults will now be the values you selected in the previous 
execution. 


Copy files 


You have already used the Copy-files command to build a 
subdirectory structure for the Widget company. Now you will learn 
more about it. To copy a file from one volume or subdirectory to 
another, type C (Copy) from the File Menu. You will get this screen: 


feple /// Utilities 
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Copy files 





The source and destination file patterns can be pathnames like 
/EMPIRE/VADER.DATA or /REBEL/SKYWALKER.DATA . These names 
each refer to a single file. We have used pathnames before. 


A file pattern, however, can be more general: it can refer to a group 
of files, by the use of a wi/dcard. Awildcard is a character that can 
stand for any other character or string of characters. For example, the 
file pattern /EMPIRE/=ADER.DATA would match 
/EMPIRE/VADER.DATA or /EMPIRE/NADER.DATA or 
/EMPIRE/MEADER.DATA. . It would not match 
/EMPIRE/MADDER.DATA . 


A file pattern can only have a single wildcard, so you could not make 
a pattern /EMPIRE/=A=H.DATA that would match 
/EMPIRE/DARTH.DATA and /EMPIRE.RALPH.DATA . In addition, the 
wildcard can only be in the the last local name in the pathname. For 
example, /EMPIRE/D=TH.DATA would be valid, but 
/EM=RE/DARTH.DATA would not. 


File patterns are convenient when copying files, as you often have to 
copy a whole bunch of them at one time. In our earlier example, for 
instance, we had to do a number of operations to copy the 
subdirectories INTERNAL and EXTERNAL from the volume directory 
/PERSONNEL to the subdirectory /PERSONNEL/COMMUNICATIONS : 
that is, to convert this catalog 


/PERSONNEL 
CURRENT 
FORMER 
COMMUNICATIONS 
INTERNAL 
EXTERNAL 


to this one: 


/PERSONNEL 
CURRENT 
FORMER 
COMMUNICATIONS 

INTERNAL 

EXTERNAL 
INTERNAL 
EXTERNAL 


The Filer 


With a wildcard, this setup does it in one stroke: 





Copy files 


A useful option of this command is the ability to copy to a printer or 
other device, simply by using the device name as the destination file 
pattern. For example, this screen setup 





Copy files 


will print the file /SKYWALKER/MEMO.TEXT to .PRINTER . Here we 
are asked 
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Press RETURN to accept the default, Yes : this causes the listing to 
be printed with a header, consisting of the pathname, the date, and 
the time of the file printed. 


Delete files 


To delete files from a volume, type D (Delete) from the File Menu. You 
will get this screen: 





Delete files 


When you type a file pattern, the Filer reads the directory specified, 
and lists the files that will be deleted if you confirm the deletion. If 
you want to get rid of all of them, type Y (Yes) and they will be 
permanently deleted; if not, type N (No) and you will have a chance to 
change the file pattern. 


Now try an experiment. With the Delete-files screen up, insert your 
/PERSONNEL diskette into the built-in drive and type 
/PERSONNEL/= as the file pattern. Don't press RETURN yet. Instead 
press the up-arrow. A list of pathnames appears on the right side of 
the screen, each matching the file pattern. Those filenames ending 
with a slash (/ ) are subdirectories. A highlight marks the first 
pathname in the list. You can move the highlight with the up- and 
down-arrow keys. 
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What's the point of these pyrotechnics? Well, you can select 
pathnames from the list, by moving the highlight to a pathname, then 
pressing the right-arrow key. An arrow-shaped marker appears by the 
selected pathname. Similarly, you can deselect a pathname by 
pressing the left-arrow key, making the marker disappear. When you 
press RETURN, the list will be culled of all the pathnames not 
selected, and you will be asked to confirm your selections: 





lf one of the files, say VADER , is a subdirectory containing files, you 
will be asked for an additional confirmation by a prompt like 





Rename files 


The Rename-files command changes only the local name of a file, not 
its contents or its place in the subdirectory structure. Thus, you can 
rename /EMPIRE/VADER/PLANS.DATA to 
/EMPIRE/VADER/SCHEMES.DATA , but not to 
/EMPIRE/TARKIN/PLANS.DATA , as the latter would move the file 
PLANS.DATA from the subdirectory VADER to the subdirectory 
TARKIN on the volume /EMPIRE . 


To rename a file, type R (Rename files) from the File Menu. You will 
get this screen; 





Rename files 


After you type the new file pattern, the Filer checks whether (a) 
anything but the local name is different in the two patterns or (b) any 
existing files on the volume match the new file pattern. If (a) is true, 
the Rename-files command is cancelled, leaving the highlight on the 
new file pattern field, so you can try a new pattern. If (b) is true, you 
will be asked to confirm that you wish to rename the files matching 
the old file pattern and delete any existing files that match the new 
file pattern: 





After thinking about it for a while, you may think it’s bizarre to use the 
old file pattern as a default for the new file pattern: why would 
anyone want to rename a file with its old name? Well, you're right, but 
it could be useful: if the new pattern were similar to the old one, we 
could edit the old pattern into the new. But how do we keep the 
default from disappearing as soon as we start typing? Press the 
right-arrow key. Now you can move back and forth, replacing any 
character you want, as if you had just typed them. You can press 
RETURN to accept the new file pattern, or ESCAPE to restore the 
default. 





Try it: type /PERSONNEL/COMMUNICATIONS/INTERNAL/ATKINS into 
the old file pattern field and press RETURN. The same pathname will 
appear in the new file pattern field. Press the right-arrow key, until 
the cursor is on the A of ATKINS . Type SMYTHE . Now press 
RETURN. 


This works fine to change 
/PERSONNEL/COMMUNICATIONS/INTERNAL/ATKINS to 
/PERSONNEL/COMMUNICATIONS/INTERNAL/SMYTHE ; but how do 
we Change it to /PERSONNEL/COMMUNICATIONS/INTERNAL/ 
BILL.ATKINS , which has a different length, without retyping a bunch 
of characters? Try an experiment. Hold down the Open Apple key and 
type | (Insert). The rectangular “replace” cursor goes away and is 
replaced by a vertical “insert” cursor, with a blinking underscore 
beneath it. The replace cursor sat on the character to be replaced; 
the insert cursor sits between two characters—any character you 
type will be inserted there. 


You can also use the insert cursor to delete characters. If you press 
the right- or left-arrow key alone, the cursor passes over a character, 
leaving it unchanged. If you press the right- or left-arrow key while 
holding down the Open Apple key, the character is swallowed up, 
never to be seen again. By pressing and releasing the Open Apple 
key while using the arrow keys, you can hop over a few characters, 
munch a few, hop a few, munch, hop... 


By editing the default in this way, you can get the input you want. To 
accept the input, press RETURN. To restore the default, press 
ESCAPE. 


Make a subdirectory 


The Make command creates a subdirectory to put files into. Before 
you can subdivide files into a subdirectory, that subdirectory, and all 
the directories above it, must exist. For example, before you can 
create a file called /EMPIRE/VADER/PLANS.DATA, the volume 
directory /EMPIRE and the subdirectory /EMPIRE/VADER must have 
been created. If you try you will ge a “Subdirectory not found” error 
message from SOS. 


To create a subdirectory, type M (Make) from the File Menu. You will 
get this screen: 





Make a subdirectory 


After you type a pathname and press RETURN, the Filer will check 
that there is no subdirectory of the same pathname: if there is, it will 
ask you whether you wish to delete the old one. If you tell it to go 
ahead, or if your pathname is unique, you will be asked how many 
files it needs to hold. Usually the default is enough: if so, press 
RETURN; if not, type a number. SOS may allocate more. If you want 
to add more files later, you will have to make a new subdirectory with 
a different name, then copy the files into it, delete the old 
subdirectory, and rename the new one. 


set Write protection 


Many diskettes have silver-colored write-protect tabs to keep the 
computer from writing on them. Well, you can also protect a file ina 
similar way, using the set-Write-protection command. Each file has a 
write-protect flag, which tells the computer whether the file can be 
written to (or deleted), or not. When the flag is set, the file is locked: 
you can read the file, and nothing else. When the flag is cleared, the 
file is unlocked: you can read, write to, or delete the file. If you have 
tried to delete (or copy over) a file and gotten a “Write protect error” 
message from SOS, this command will let you go ahead. 





To change a file’s write-protect flag, type W (set Write protection) from 
the File Menu. You will get this screen. 





set Write protection 


After typing the file pattern and pressing RETURN, type Y (Yes) or N 
(No) to lock or unlock the file. 


set Prefix 


The set-Prefix command sets the SOS prefix, which is appended to 
partial pathnames not starting with a slash (/ ) or period. For 
example, if the prefix is /PERSONNEL , when you type 
COMMUNICATIONS in response to a file pattern request you will get 
/PERSONNEL/COMMUNICATIONS . If you type /COMMUNICATIONS/ 
INTERNAL/ATKINS/MAR.15.TEXT , the prefix will not be added. To set 
the prefix, type P (set Prefix) from the File Menu. You will get this 
screen: 
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set Prefix 


An interesting use of a prefix is this: we have a large disk, called 
/WIDGET . On this disk we wish to make an “image” of the diskette 
/PERSONNEL : that is, a reproduction of its entire subdirectory 
structure. First we set the prefix to /WIDGET : 





set Prefix 


After pressing RETURN, we then type C to bring up the Copy screen, 
and type the following inputs: 





Copy files 


This command will copy the volume directory /PERSONNEL and all of 
its subordinate files to the subdirectory PERSONNEL on the volume 
/WIDGET . Here is an outline of the directory for /WIDGET : 


WIDGET 
ACCOUNTING 
PAYABLE 
RECEIVABLE 
INVENTORY 
PERSONNEL 
CURRENT 
SIMPSON 
FORMER 
JOHNSON 
COMMUNICATIONS 
INTERNAL 
ATKINS 
MARCH.15 
EXTERNAL 


As you can see, the directory structure under the subdirectory 
PERSONNEL on the large disk /WIDGET looks like the directory 
structure of the volume directory of the diskette /PERSONNEL . 





Operations On Devices 





The Utilities Diskette has a number of commands that operate on 
input/output devices. Some of them work only on block devices, like 
disk drives, that store data: you can copy one volume to another, 
rename a volume, format a volume to hold data, or verify that a 
volume is readable. Other commands operate on all devices: you can 
list the devices the operating system knows about, or set the system's 
time and date. 


In the case of floppy-disk drives, the volume name is that of the 
diskette (a diskette is always a single volume), and the name follows 
it as it migrates from drive to drive. In the case of other block devices, 
the relationship between volumes and devices may vary, but this 
remains constant: the device name never changes, and always refers 
to the whole device. Since we will only discuss (Disk lil) floppy-disk 
drives in this manual, you can assume that a diskettes volume name 
and its drive's device name can be used interchangeably as long as 
the diskette remains in that drive. 


All the commands discussed in this section operate on an entire 
device. Other commands, which operate on files, were discussed in 
the previous section, “Operations on Files”. 


To use any of the device commands, boot the Utilities Diskette (if 
necessary) and select option D (Device handling commands) from the 
Main Menu. This will get you the following menu: 
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Device Menu 





Typing any of the letters in the left column will get you the screen for 
the command it stands for. You can also use the up-and down-arrows 
to move the selection, and press RETURN to accept a selection. 
Copy-volume is the default: if you press RETURN without typing 
anything, you will get the Copy-volume screen. To return to the Main 
Menu, press the ESCAPE key. 


Copy one volume onto another 


You have already used the Copy command to make a backup of your 
Utilities Diskette. This command replicates the contents of one device 
or volume on another device or volume with the same number of 
blocks: for example, from one Disk III to another. 


For example, you could copy .D1 to .D2 ; or you could copy 
/SKYWALKER in .D1 to /VADER in .D1 , if you had a one-drive system 
(you would have to do some diskette-swapping). You could not copy 
a Disk III’s contents to a disk drive of different capacity or format, 
such as a hard disk. For this you would have to use the Copy files 
command, described in the section Operations on Files, preceding. 


When you type C (Copy one volume onto another) from the Device 
Menu you get this screen 





Copy one volume onto another 


with a series of fields to fill in, the topmost field highlighted. Each 
field is a question you must answer; it contains a default response, 
which is the program's guess as to your most probable answer. The 
ones displayed above are for a 2-drive system. If the program 

guessed correctly, you can accept the default in the highlighted field 
by pressing RETURN. If not, type the correct response. If you wish to 
change your response, move the cursor back with the left-arrow key 
and type over. When you are satisfied, press RETURN to accept the 
current field's contents and move to the next field. You can back up to 
the previous field by pressing CTRL-RETURN. 


First you specify the source volume by typing the device name of the 
drive, or the volume name of the diskette, you wish to copy from; 
then insert the source volume into the appropriate drive and press 
RETURN. 


Then the copy program will try to read the source volume'’s directory. 
If it doesn't find a directory, or you typed a volume name that cannot 
be found, it will ask you to insert the proper volume. 


Next you specify the destination volume by typing the name of the 
drive or diskette you wish to copy to; then insert the destination 
volume into the appropriate drive and press RETURN. 


It is a good idea to put a write-protect tab on a 


diskette you wish to copy from. This way, if you 
specify the source and destination volumes 
incorrectly—say, if someone interrupts you to ask a 
question—you will get an error message rather than 
erasing the wrong diskette. You didn't need to do this 
with the Utilities diskette, because the original is 
write-protected: it doesn’t have a notch on its right 
side. 


The next field asks you for the volume name you wish the copy 
volume to have: this allows you to make two diskettes with the same 





contents and different names. Type the new destination volume 
name, if different from the source. If you have made any mistakes, 
you can back up and change any field you want by using CONTROL- 
RETURNs. When you are satisfied, accept the destination volume 
name by pressing RETURN to go ahead with the copy. 


D> When making a 1-drive copy, it is advisable to use the 
diskettes volume names, not the device name. This 
way, you can be sure that you and the system agree 
on which diskette is the source and which is the 
destination. 


Then the copy program will try to read the destination volume's 
directory. If it finds a directory and any files on the volume, you will 
be asked something like 





If you reply Y (Yes), the destination volume will be reformatted and 
the source volume will be copied onto the destination volume. The 
previous contents of /VADER , and its very name, will be obliterated. 
If you reply N (No), you will return to the Copy screen. 


lf you are doing a 1-drive copy, you will need to swap diskettes 
several times before you are finished: each time, the program will 
prompt you to insert the proper diskette, and will check its name 
after you insert it. 


lf you interrupt the copy process, the source volume will be 
unaffected, but the destination volume will be unusable. If this 
happens, simply start the copy process over again. 


You can repeat the copy process as many times as you like without 
retyping any of the fields: simply put in the next destination diskette 
and press RETURN to accept each field as currently specified. To 
return to the Device Menu, press ESCAPE. 


Rename a volume 


This command lets you change the name of a volume, without 
changing its contents. If you type R (Rename a volume) from the 
Device Menu (with the volume to be renamed connected to the 
system), you will get the following screen: 





Rename a volume 


As with the Copy-volume command, you can use the defauit or type 
your own volume or device name (as long as you dont try to rename 
the boot volume), then move on to the next field by pressing 
RETURN. Now type the new volume name, or edit the default. The 
new volume name must not match the name of any volume 
connected to the system. When both fields are the way you want 
them, press RETURN. 


Format a volume 


The Format command prepares a volume, such as a diskette, to hold 
data by dividing it into tracks and sectors of uniform size and writing 
a directory on it. The same Format command works on any block 
device configured into your system. 





lf you type F (Format a volume) from the Device Menu, you will get 
the following screen: 





Format a volume 


As with the Copy-volume command, you can use the defaults or fill in 
your own names. The default for the volume name will be a name 
from BLANKOO to BLANK9Y9, assigned randomly by the formatting 
program. If you format a bunch of volumes in a row, they will be 
numbered in series from the first random number. This changing 
default makes it easy to make sure your volumes have unique names. 


When you are satisfied, press RETURN. The program will try to read 
the directory of the destination volume. If there is one, you will get a 
message like 





An answer of Y (Yes) will cause the volume to be reformatted. An 
answer of N (No) will leave you at the top of the Format screen. 


By pressing ESCAPE, you can go back to the Device Menu. 





Verify a volume 


Sometimes you may suspect that a volume has been damaged or its 
data has been scrambled. To check the volume, use the Verify 
command, which checks each block for evidence of errors. Each 
block of a volume has a number, called a checksum, that is derived 
from the contents of the block, and changes any time the contents 
are changed. The Verify command computes the checksum each 
block should have, and compares it with the checksum it does have: 
if they match, the block is OK; if not, it is faulty. To find any bad 
blocks on a volume, type V (Verify) from the Device Menu. You will get 
this screen: 





Verify a volume 


First you specify the volume to be verified, using the default if it fits, 
and press RETURN. Then you specify the number of blocks to be 
checked: usually you will want all of them, which is the default. If the 
volume has no directory, there will be no default number of blocks. 
When you press RETURN, the volume will be verified. If it is OK, you 
will get this message: 
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If the volume is not OK, you will a message like this: 





lf you have any bad blocks, it is a good idea to copy all the intact files 
(those not endangered) to another volume, using the Copy File 
option on the File Menu. Using the Copy Volume option on the Device 
Menu will copy the error, as well as the intact files. 


List devices configured into system 


This command lists the devices and volumes configured into your 
system. If you type L (List) from the Device Menu, you will get a list of 
all devices the operating system can communicate with, like this: 





List devices configured into system 


The list shows the device name of each device and the volume name, 
if any, of each block device. An empty disk drive will, not surprisingly, 
have no volume name. 


set Time and date 


Every time you store information on a volume, the file containing the 
information is marked with a date and time; every time the file's 
contents are changed, the date and time are updated. The date and 
time are stored on the Utilities Diskette. To change the date and time, 
use the set-Time command. From the Device Menu, type T (set Time) 
and press Return. You will get a display like this: 





set Time and date 


If you want to keep the same date, press RETURN. If you want to 
change the date, you type the day first, then the month, then the year, 
all separated by hyphens. (You can use the arrow keys to avoid 
retyping the defaults). The day must be a number. The month must be 
the first three letters of the month's name. The year must be a 2-digit 
number. If we are still making Apple IIl’s in 2001, we'll revise SOS to 
handle the new dates. When you have the date you want, press 
RETURN to set the time. 


If you want to keep the same time, press RETURN. If you want to 
change the time, type the hour, minute, and second, separated by 
colons. (You can use the arrows as above.) When you have the time 
you want, press RETURN. 





Utilities Diskette Selection and Editing 





Menu Selection 


You may select an option from a menu in one of two ways. You can 
either type the letter or digits displayed to the left of your chosen 
option—remember to press the RETURN key if the message “Press 
RETURN to accept” is present on the screen. Or, if you prefer, you 
may use the up- and down-arrow keys to move through the menu, 
and press the RETURN key when you have reached the correct item. 


Editing Input Fields 


When the Utility program (which includes the Filer and the SCP) 

requests information, it displays a prompt telling you what it needs 
and a highlighted field with the cursor inside. Frequently, a default 
response will appear in the field. You may respond in several ways. 


lf you wish to return to the previous menu, press the ESCAPE key as 
the first character of your response. If you wish to return to the 
previous field on the screen, press the RETURN key while holding 
down the CONTROL key. If the default response is correct, press the 
RETURN key to accept it. If the quess Is incorrect, type the correct 
information, and then press the RETURN key when you are finished. 


The Utility program provides some features for editing the contents of 
input fields. They are invoked by special keys or key combinations. 


While typing information, you can use the left- and right-arrow keys 
to move the cursor back and forth within the field to correct typing 
mistakes. When the cursor is located on incorrect characters, type in 
the correct characters. When you have corrected your mistakes, 
press the RETURN key to accept the contents of the whole field as 
displayed. If you do not want to accept all of the characters in the 
field, you must delete all those you don’t want. 


lf you decide there is a character in the field that doesn't belong 
there, you can delete it. Move the cursor on top of the offending 
character, then press the right-arrow key while holding down the 





Open Apple key. This deletes the character under the cursor from the 
field and moves the remaining characters one to the left. You can also 
delete characters to the left of the cursor by pressing the left-arrow 
key while holding down the Open Appie key. 


To add characters to a field, move the cursor to the point where you 
want to insert, and press the | key while holding down the Open 
Apple key. This puts you in insert mode, and all characters you type 
are inserted between two characters already in the field. Notice that 
the cursor indicates insert mode by switching to a vertical bar 
between two characters (with a blinking underline line to help you 
find it). You leave insert mode the same way you enter it: by typing | 
while holding down the Open Apple key. You can also move and 
delete characters in insert mode by using the left- and right-arrow 
keys. 


If the default response provided is nearly correct, you can edit it. If 
you begin to type your own response, the default will disappear. But if 
the first key you press is an arrow key or Open Apple key, the default 
will not disappear, and you can modify it until it is what you want. 


lf you are editing the characters within a field, and decide you would 
like to restore the characters in the field to the default response, 
press the ESCAPE key. You now have the same options as you did 
upon entering the field. If you wish to return to the parent menu, 
press the ESCAPE key again. 


Pathname Selection 


Certain fields request that you provide one or more pathnames of 
files or devices. In addition to the capabilities described above, the 
following additional editing features are available. While you are 
typing a pathname, you can display a directory containing all the files 
that match the pathname. After looking through this directory, you 
can select a subset for use, or select one pathname to enter into the 
field. 


File patterns: To specify a group of files in a directory, you use a file 
pattern. A file pattern is a pathname with a wildcard in the local 
name. The wildcard character is the equal sign ( = ). A file pattern 
containing a wildcard describes all files whose name matches the file 





pattern with the wildcard replaced by appropriate characters. For 
example, if the directory /EMPIRE contains the files 


VADER.DATA 
NADER.DATA 
MEADER.DATA 
MADDER.DATA 


then /EMPIRE/=ADER.DATA describes the first three. 


Entering pathname menu: Type a file pattern, then press the up- or 
down-arrow key. A menu now appears on the screen of all the files 
that match that pattern. If no wildcard appears in the field, then one 
will be added at the end to display all files in the directory specified 
whose loca! names start with the characters typed. 


Moving: The first file in the list will be highlighted. You can move the 
highlight up or down the list with the up- or down-arrow keys. 


Selection: Select a file in the list by typing a right-arrow. A right- 
arrow will appear on the screen pointing to the files to remind you 
which have been selected. If a command in the filer expects a group 
of files, you may select more than one. 


Deselection: To change your mind and deselect a file, move the 
highlight to the file and type a left-arrow. 


Acceptance: Type an ENTER to continue editing the string you were 
typing. If you selected exactly one file, its name will enter into the 
field. If the selected file is a subdirectory (indicated by slash to the 
right of the file name in the selection list), you may add characters 
and type an up- or down-arrow again to select from the files in that 
subdirectory. You may then use any of the selection commands 
outlined above. If you have selected a group of files and you type an 
up- or down-arrow again, you may further narrow down the 
subgroup. Type a RETURN to accept the whole field. (ENTER 
RETURN is equivalent to just a RETURN). 





Summary of Editing Features 





RETURN 


CONTROL-RETURN 


ESCAPE 


Left-arrow 


Right-arrow 


Open-Apple-! 


Open-Apple-Left-arrow 


Open-Apple-Right-arrow 


Accepts the contents of the field. Moves 
the cursor to the next field on the screen. 
If the cursor is within the last field on the 
screen, the command is executed. 


Moves the cursor to the previous field on 
the screen. 


As the first keypress in response to a 
default response: 
Returns to the parent menu. 
As any other keypress in a field: 
Restores the default response. 


Moves the cursor one character to the 
left. 


Moves the cursor one character to the 
right. 


Turns insert mode on and off. 


Deletes the character immediately left of 
the cursor. 


Normally deletes the character under the 
cursor. Deletes the character immediately 
right of the cursor in insert mode. 


Summary of Pathname-Selection Keys 


= Wildcard character. In pathname, may be replaced by 
any characters to match local names on the volume. 


Up-arrow In field editing of a pathname: 
Enter file selection mode. 
In file-selection mode: 
Move highlight up one pathname. 


Down-arrow _ In field editing of a pathname: 
Enter file-selection mode. 
In file-selection mode: 
Move highlight down one pathname. 


Right-arrow _ In file-selection mode: Select the highlighted 


pathname. 

Left-arrow In file-selection mode: Deselect the highlighted 
pathname. 

ENTER Accept the group of selected pathnames and return to 
field editing. 

RETURN Accept the group of selected pathnames and accept 


the field. (This is the same as ENTER followed by 
RETURN.) 





The Machine 


The Front 





Two things are prominent on the front of your Apple Ill: the typewriter- 
like keyboard and the slot for the disk drive. 


The Keyboard 


The Apple Ill Keyboard has two sections: the 61-key main keyboard 
and the 13-key numeric keypad. 


The main keyboard has letters, numbers, and special symbols in 
traditional typewriter layout. All ASCII characters are included. The 
CONTROL, SHIFT, and ALPHA LOCK keys are used to modify the 
character codes produced by the other keys. The two Apple keys 
(Open Apple and Closed Apple, to the left of the spacebar) can also 
be used to modify the meaning of the characters. 


The RETURN, ESCAPE, TAB, ENTER, and four directional arrow keys 
produce control characters. Control characters are used in various 
ways by different programs. 


lf you hold down any key (except CONTROL, SHIFT, ALPHA LOCK, or 
the Apple keys) for more than one half second, it will repeat 
automatically at a rate of 11 characters per second. If you press and 
hold down the Closed Apple key while pressing another key, that key 
will repeat at a rate of 33 characters per second. Each of the four 
directional arrow keys has three positions: unpressed; pressed so 
that it clicks once, the 11-characters-per-second position; and, 
pressed harder so that it clicks again, the 33-characters-per-second 
position. 


The thirteen keys on the numeric keypad generate the same 
characters as their main keyboard counterparts. They are grouped 
here to make entry of numbers easier, as on an adding machine. Even 
though the keys on the numeric keypad generate the same ASCII 
codes as their counterparts on the main keyboard, a program can 
detect whether a pressed key is on the numeric keypad or on the 
main keyboard. 


The ENTER key on the numeric keypad is the same as the RETURN 
key on the main keyboard. 


The Disk Drive 


The other prominent feature on the face of the Apple Ill is the access 
slot for the built-in disk drive. To insert or remove a diskette, you must 
first open the disk drive door by pulling up on its bottom edge. 


You should insert a diskette into the drive with its label upwards and 
its oval slot pointing into the drive. The built-in disk drive is slightly 
lower in back than it is in front; you should point diskettes slightly 
downwards when you insert them into the Apple Ill. Make sure when 
you are inserting a diskette that you push it in all the way: if the 
diskette is not completely inserted, you cannot close the door. 


The Apple III can read from or write to a diskette only when the 
diskette is fully in the drive and the door is closed. When the Apple III 
is using the disk drive, the red light under the drive door will come 
on. This is an indication that the diskette is spinning and that the 
Apple Ill is reading from or writing to the diskette. 


When the IN USE light is on, you should not open the 
drive door or turn the Apple Ill off. Either of these 


actions could cause the head to write un-readable 
information on the diskette. 


Sometimes a disk drive makes a loud raspy noise, as if it’s clearing its 
throat. This happens when the disk drive door is open, during the 
formatting process, and at various other times. The noise is caused 
when the disk head is being set for accuracy; it is nothing to worry 
about. 





Installing External Devices 





Many devices will plug directly into the back of the Apple Ill, as the 
video monitor does. Apple Disk Ill drives plug into the slot marked 
“FLOPPY DISKS"; the QUME letter-quality printer connects to the 
plug marked “PORT C” on the back of the Apple III; Cursor III 
joysticks plug into “PORT A’ or “PORT B”: and the Silentype printer 
plugs into “PORT A’. 


Other devices attach to peripheral interface cards, which you install 
inside the Apple Ill. Read the manual accompanying each device to 
see how it should be installed, or get your dealer to help you. 


#2 IMPORTANT *#%* 


Before connecting or disconnecting 
ANYTHING 
on the Apple Ill, 
TURN OFF THE POWER. 
This is a MUST. 


Instructions for installing Disk III Drives are given in a previous 
chapter. To install other devices that plug into the back of the 

Apple Ill, see the following section, “The Back”. For devices that must 
be installed inside the Apple Ill, see the section “Inside the Apple III’, 
also in this chapter. 


Many devices, especially those installed inside the Apple III, will be 
supplied with a diskette containing programs to operate that device. 
These programs, called device drivers, must be installed in your 
Apple Ill diskettes just as the hardware is installed in your Apple Ill. 
The Apple III Standard Device Drivers Manual, which accompanies 
this manual, describes how to install these programs. 





The Back 





The back and most of the case of the Apple Ill is made of cast 
aluminum, with vertical fins along the back and part of the sides. 
These fins dissipate heat generated by the circuitry of the computer, 
in much the same way as the fins on a radiator or engine cylinder. 
Thus the Apple Ill does not need a fan to cool itself. The fins and the 


aluminum part of the case get warm while the Apple Ill is operating; 
this is a normal condition. 





The Back of the Apple lil 


The Apple Ill must be placed on a firm surface so that 


air can circulate freely about it. An Apple Ill placed on 
a deep pile carpet will become too hot, and may shut 
itself off until it has cooled down. 


Most devices you use with your Apple III plug directly into one of the 
ports on the back panel of the computer. The back of the Apple III 
also has four large, vertical access slots that hold connectors for 
peripheral interface cards (these are discussed in the next section, 
“Inside the Apple III"). 


* 2k WARNING! *-k 


Before connecting or disconnecting 
ANYTHING 
on your Apple Ill, 
TURN OFF THE POWER SWITCH. 
This is a MUST. 


The Power Switch and Connector 


On the right side of the back of your Apple III (looking from the rear) 
are the power connector and power switch. The Apple III accepts 
power-line input in the range of 107 to 132 volts, 60 Hertz alternating 
current. The connector has three prongs: two for line voltage, and 
one for earth ground. 


The power switch is located next to the power connector. The switch 
has two positions: ON (labeled “ON” or “1") and OFF (labeled “OFF” 
or “0"). When the power to the Apple III is on, the power-on indicator 
on the keyboard (to the left of the spacebar) lights up with the word 
ON. 


The Disk Drive Connector 


The leftmost connector (looking from the rear) on the back of the 
Apple Ill, marked FLOPPY DISKS, enables you to connect up to three 
additional Apple Disk III drives to your Apple Ill. The first additional 
drive plugs into the Apple Ill. The second additional drive plugs into 
the first, and the third plugs into the second. This connection scheme 
is called a “daisy chain”. 


You should never connect more than three external 


disk drives to the FLOPPY DISKS connector of the 
Apple Ill. Also, the disk drive connector is meant to 
connect only to Apple Computer's Disk Ill drives. DO 
NOT CONNECT ANY OTHER PRODUCTS OR 
PERIPHERALS TO THIS CONNECTOR: you may 
damage both the peripheral and your Apple Ill. 


lf you want to connect a hard disk to your Apple Ill, you may still have 
up to three Apple Disk III drives. Hard disks are connected through 
the slots inside the Apple Ill’s case, and are controlled separately 
from the floppy disks. 


oS Before you can use a second or third external drive, 
you must configure the system to recognize it, as 
explained in the chapter on the Utilities Diskette. 


The Joystick Ports 


Next to the disk drive connector are two nine-pin D-type connectors 
that allow you to connect miscellaneous input and output devices to 
your Apple Ill. Each connector provides access to one joystick port. 
The most common use for these ports is to connect to Apple 

Cursor Ill joysticks. 


(A joystick is an input device that resembles the control stick of an 
airplane. The stick moves in two dimensions: forward-backward and 
left-right. Apple Ill programs can use inputs from a joystick to move 
things around on the screen.) 


Each port has circuitry for the X- and Y-axis joystick inputs, and for a 
pushbutton and a switch input. Electrical specifications for these 
ports are given in Appendix C. 


The Silentype Printer Port 


In addition to its function as a joystick port, port A on the back of 
your Apple Ill can also be connected to an Apple Silentype printer. 
Details of the connection, setup, and operation of the Silentype are 
given in the manual accompanying the Silentype. 


The Color Video Port 


If you wish to connect your Apple Ill to some display device other 
than the standard black and white monitor, you may need to use the 
COLOR VIDEO port located to the right of ports A and B. This 15-pin 
D-type connector carries National Television Standards Committee 


(NTSC) compatible, positive composite synchronization, color and 
black and white video signals. The port also carries composite 
synchronization signals and other signals that can create Red, Green, 
and Blue (RGB) color video output, as well as all four power supply 
voltages. 


The signals available on this port allow you to connect your Apple III 
to any color or black-and-white video monitor, an RGB studio quality 
monitor, a video tape recorder, or any other video device. For full 
details of the signals available on this port, please see Appendix C. 


The B/W Video Port 


The round connector immediately to the right of the color video 
connector, marked B/W VIDEO, carries only the black and white, 
positive composite synchronization video signal. This connector is an 
RCA-type female phono jack and will connect to any male RCA-type 
phono plug. A cable with such a plug is included with your Apple Ill. 


Physical specifications of this jack and electrical specifications of its 
port can be found in Appendix C. 


The Audio Port 


Any sound generated by the Apple Ill’s speaker can be captured and 
sent to an external speaker, tape recorder, amplifier, or other device 
by connecting that device to the AUDIO jack on the back of the 
Apple Ill. When you insert a miniature phone-tip plug into this jack, 
the Apple Ill’s internal speaker is silenced; if there is an amplifier or 
other device properly connected to the plug, then that device will 
receive all audio signals generated by the Apple Ill. 


Physical and electrical specifications of this jack can be found in 
Appendix C. 


The Serial Port 


Port C lets you connect the Apple Ill to all devices that use the RS- 
232-C standard communication format. This includes letter-quality 
printers, high-speed-data collection devices, other computers, 


modems, and many other devices. The RS-232-C protocol was 
specified by the Electrical Industries Association (EIA). 


The electrical specifications for this port are given in Appendix C. 


Inside the Apple IIl 





The inside of your Apple Ill contains the most important parts of the 
computer. You need to see the inside of your Apple Ill only when you 
are installing or removing interface cards for peripheral devices, or 
using the security mount to attach the Apple II| to a table or shelf to 
prevent theft. 


Before removing the cover of your Apple III, or 


connecting or disconnecting anything on the inside or 
outside, TURN OFF THE POWER SWITCH. 


Removing the Cover 


The cover is attached to the case of the Apple III by two quarter-turn 
screws located on the base, under the lower left and lower right 
corners of the face of the Apple Ill: 





Cover Attachment Screw Locations 





After turning the power off, use a short, flat-blade screwdriver to turn 
both of these screws one-quarter turn in either direction. If you don't 
have a screwdriver short enough, remove all the connections from 
the back of the Apple Ill and tilt it up onto its backside to loosen the 
screws. They should loosen and fall down (they re captive screws and 
won't fall out of the case). Remove the cover by lifting it straight up. 


Because of electromagnetic-interference regulations, 
the United States Federal Communications 
Commission (FCC) prohibits the operation of an 
Apple Ill with its cover removed. To remind you of this, 
when you open the cover of your Apple Ill, there is a 
small red light on the left side of the main board, near 
the back. If you see that this light is on, TURN YOUR 
APPLE IIl OFF! (Don't forget to save any programs or 
data you might be working on.) This light is intended 
to protect your Apple Ill by reminding you that the 
power is still on. You should not remove the cover of 
the Apple Ill or connect or disconnect anything while 
the power Is on. 








The Inside of the Apple III 


Peripheral Device Cards 


On the inside of the Apple Ill, between the disk drive and the power 
Supply, is a rectangular well. At the bottom of this well are four iong 


connector sockets, mounted on the main board. These connector 
sockets, called peripheral connectors or slots, are meant to hold 
Apple Ill peripheral interface cards. With these slots, you can connect 
your Apple Ill to many devices that cannot be plugged into an 

Apple Ill port or connector. 


The four peripheral slots are numbered from 1 to 4, counting from 
left to right, as viewed from the front of the machine. Peripheral 
interface cards can usually be placed in any of the four slots; to find 
out the particular slot into which a given interface card should be 
installed, consult the manual accompanying that card. 


As a precaution, some Apple Ills were shipped with dummy cards 
inserted into their slots. The sole purpose of these cards is to hold 
the metal shields that cover the four vertical access slots in the back 
of the Apple Ill’s case. These shields prevent excessive radio- 
frequency interference (RFI) from leaking from the Apple Ill. This was 
later deemed unnecessary and the shipment of the dummy cards was 
discontinued. Apple III interface cards have similar shields, some of 
which may have plugs, connectors, or switches mounted on them. If 
your Apple Ill has dummy cards, then you must remove one each time 
you wish to install a peripheral card into a slot. 





Removing Peripheral Cards 


Peripheral interface cards are supported on the bottom by the 
peripheral slots, on the back by their metal shields, and on the front 
by notches in the front of the well. These notches are called “card 
guides’. 


To remove a peripheral interface card (or a dummy card), you should 

pull straight up on it. To assist you, there is a hole drilled in the top of 
each card, near the back of the card. You can use a hook in this hole 
to pull the card straight up, or you can gently pry the card up witha 

screwdriver, using the side of the well for leverage. 


Pull the card straight up and out of the well. The shield, which fits 
into one of the tall vertical access slots in the back of the Apple Ill, 
may be tight: you may have to push it up with your forefinger to 
remove the card. 





Removing a Peripheral Card 


es Handle any peripheral interface card as you would 
handle a high-quality, expensive phonograph record. 
Grasp it only by the corners or edges, and try not to 
touch the delicate components or pins. Don't grasp 
the card by the gold or silver contact “fingers”: they 
are the way the Apple III communicates with the card, 
and their efficiency is decreased if they are dirty or 
scratched. Interface cards are precision instruments 


and should be handled with care. Store unused 
interface cards in the boxes in which they were 
shipped. 


Installing Peripheral Cards 


To install a peripheral interface card in your Apple Ill, first see the 
manual accompanying the card to determine which slot the card 
belongs in. Then, if there is a dummy card in that slot, remove it (see 
above). 


With the Apple Ill facing you, and the cover (and the power) off, hold 
the card with the silver or gold “fingers” pointing down into the 
Apple Ill. The components should be on the right side of the board. 
Slide the near edge of the card into the card guide and the metal 
shield into the access slot, like this: 





Installing a Peripheral Card 


Slide the card evenly down until the “fingers” enter the peripheral 
connector itself. At this point, the metal shield should be tightening 
up in the access slot. Now you re going to have to use just a little 
force (not too much) to fit the card completely into its slot. You can 
tell that the card is fully inserted when the top of the metal shield is 
flush with the top edge of the access slot. 





A Fully Inserted Peripheral Card 


lf the peripheral card doesn't seem to fit, remove it completely and try 
again, making sure that the card enters the card guide straight up 
and down. 


The Speaker 


The Apple III's internal speaker is mounted on the front of the face of 
the Apple Ill, right inside the top cover. The speaker is mounted 
facing the front of the computer, and is connected to the main board 
by a long twisted pair of wires. The sounds generated by the speaker 
can be controlled by your programs, but the volume of the speaker 
cannot be adjusted. The speaker can be silenced by inserting a 
miniature phono plug in the AUDIO jack in the back of the Apple III 
(see the previous section). 


The Security Mount 


On the inside of the Apple Ill, just to the left of the internal speaker, is 
a hole in the baseplate of the Apple III through which you can install a 
strong bolt. With this bolt, you can secure the Apple Ill to a table, 
shelf, chain, or other secure stronghold to prevent theft. 








security Mount and Bolt 


The hole is unthreaded, .25 inch in diameter, and .15 inch deep. The 
well around the top of the hole is .5 inch wide and 1.25 inches long. 


Replacing the Cover 


To replace the cover on your Apple Ill, fit it onto the top of the Apple III 
so that the back of the cover is flush with the back of the computer 
and the holes on the underside of the front of the cover fit over the 
two quarter-turn screws. Retighten the two screws by pushing up on 
them and turning them each one-quarter turn in either direction with 
a flat-bladed screwdriver (you might have to tilt the Apple III up again 
to do this). 


The Bottom 





The bottom of the Apple Ill contains access panels for the power 
supply and main board electronics. You should never open either of 
these panels: they are for authorized service personnel only and 
opening them may invalidate your warranty. 











Error Messages 


Errors During Startup 





Diagnostic Messages 


When you turn on your Apple Ill, it performs a number of diagnostic 
checks on its hardware. If any of these tests fail, you will get one of 
the diagnostic messages below. If you get one of these messages, see 
your dealer. Do not use the computer: a defective computer could 
erase data from your diskettes. 


RAM The test of the Apple Ill's random-access memory failed. The 
pattern on the screen indicates which component is faulty. See your 
dealer. 


ROM The test of the Apple Ill’s read-only memory failed. See your 
dealer. 


ACIA_ The test of the Asynchronous Communications Interface 
Adapter (ACIA), which controls the RS-232-C serial port, failed. See 
your dealer. 


VIA_ The test of the Versatile Interface Adapters (VIAs), which control 
various internal functions in the Apple Ill, failed. See your dealer. 


A/D The test of the Analog-to-Digital converter, which controls the 
joysticks, failed. See your dealer. 


ZP The Zero Page test, which determines whether the Apple III's 
memory addressing circuitry is operational, failed. See your dealer. 


SOS Errors 


If the Apple lil passes the diagnostic tests, it tries to boot the diskette 
in the built-in drive. If an error occurs during the boot process, a 
message is displayed (in black characters on a white background) in 
the middle of the video screen, the Apple beeps, and the system 
waits for you to try again. Any boot error is a fatal error: you must 
insert a proper boot diskette, hold down the CONTROL key and press 
the RESET button to reboot, generally with a different diskette. 


These errors can be produced during a bootstrap operation: 


(Blank screen) The diskette in the built-in disk drive is not a boot 
diskette. Insert a proper boot diskette into the built-in disk drive, hold 
down the CONTROL key and press RESET to attempt to reboot. 


RETRY The disk boot failed. Either there is no diskette in the built- 
in disk drive, or the diskette is unformatted, or the data on the 
diskette has been destroyed; or the diskette is not inserted straight. 
Remove and reinsert the diskette, making sure it it is straight. If the 
error occurs repeatedly, place a known good boot diskette in the 
built-in drive, close the door, and attempt to reboot. If the error 
occurs with several boot diskettes, see your dealer. 


DRIVER FILE NOT FOUND There is no file named SOS.DRIVER 
listed in the volume directory of the boot diskette. SOS cannot 
operate without device drivers, and the drivers must be stored ina 
file with this name, in the volume directory of the diskette. 


DRIVER FILE TOO LARGE The SOS.DRIVER file is too large to fit 
into the system’s memory along with the interpreter. Use the System 
Configuration Program to remove one or more drivers from this file. 


EMPTY DRIVER FILE The SOS.DRIVER file contains no device 
drivers. SOS requires at least one device driver, usually CONSOLE, to 
operate most interpreters. 


INCOMPATIBLE INTERPRETER The interpreter is either too large 
or specifies a loading location that conflicts with SOS. This error 
usually occurs when trying to load an older interpreter with a newer 
version of SOS. 


INTERPRETER FILE NOT FOUND There is no file named 
SOS.INTERP listed in the volume directory of the boot diskette. SOS 
cannot operate without an interpreter, and the interpreter must be 
stored in a file with this name, in the volume directory of the diskette. 


INVALID INTERPRETER FILE The SOS.INTERP file is not in the 
proper format for an interpreter file. This error occurs when a file that 
is not an interpreter is assigned the name SOS.INTERP and the 
system is then booted. 


INVALID DRIVER FILE The SOS.DRIVER file is not in the proper 
format for a driver file. Make sure that the file was either created by 
the System Configuration program or obtained from a valid Apple III 
boot diskette. 


I/O ERROR The loader has encountered an |/O error while trying to 
read the kernel, interpreter, or driver file from the diskette in the 
Apple Ill’s internal disk drive. Make sure the diskette is correct and 
properly inserted in the drive. If the error occurs with several boot 
diskettes, see your dealer. 


KERNEL FILE NOT FOUND There is no file named SOS.KERNEL 
listed in the volume directory of the boot diskette. The files 
SOS.KERNEL, SOS.INTERP, and SOS.DRIVER must all be present in 
the volume directory of a diskette to be booted. 


ROM ERROR: PLEASE NOTIFY YOUR DEALER Your Apple III 
contains an older version of the bootstrap ROM, which is not 
supported by this version of SOS. Your Apple dealer should be able to 
replace the ROM at no cost. If you receive this message, please 
contact your dealer or the nearest Apple Service Center. 


TOO MANY BLOCK DEVICES The SOS.DRIVER file contains too 
many block device drivers. Use the System Configuration Program to 
remove one or more of the block device drivers from this file. 





SCP Errors 





These errors are reported during the operation of the System 
Configuration Program. 


No device drivers have been read Youre not allowed to do lots of 
things until you've read at least one. 


Errors In Reading Driver Files 


lilegal wildcard Either (a) two wildcards were used where only one 
is allowed, or (b) a wildcard was used when only a single file is 
allowed (e.g., you can't send a directory listing to multiple files). 


Invalid pathname’ The specified pathname violates the syntax rules 
for pathnames. A common error is more than 15 characters in a local 
name. 


Pathname too long The specified pathname has more than 80 
characters. 


Errors In Editing System Parameters 


File contents incorrect The character set or keyboard set contains 
invalid data. 


Slot number may not be altered for this driver This driver works 
only if its device is in a particular slot. 


Errors While Generating System 


These errors will not prevent SCP from generating the system 
configuration, but they indicate that the system may not work. 


Character set not loaded Use Edit System Parameters to set the 
required items. 


Duplicate driver names Use Edit Driver Parameters to change 
driver name of one of two. 


Keyboard layout not loaded Use Edit System Parameters to set the 
required items. 


One or more drivers require slot assignments Use Edit System 
Parameters to set the required items. 


System parameters are not set Use Edit System Parameters to set 
the required items. 


Filer Errors 





These errors are reported during the operation of the Filer: 


Bad disk medium/drive The disk has been physically damaged and 
is unusable, or the disk drive is malfunctioning. 


Blocked volume name expected You specified a character device 
name when a block device name was expected. 


Cannot read source diskette The diskette that you are trying to 
make a copy of is unreadable. Make sure you have specified the 
proper source and destination drives, and that the diskette is 
correctly inserted in the source drive. 


Command requires SOS-format disk This command (e.g., Make a 
subdirectory) works only on SOS disks, not on UCSD-format disks. 


Device dependent error #N See manufacturer's documentation. 
The specified device is not connected to the system or is turned off. 


Device not configured into the system The driver for the specified 
device is not in the system configuration. 


Device noton line The specified device is not connected, not 
turned on, or (if a block device) has an open door or contains no 
volume or an unformatted volume. 


Directory already exists The specified operation will create a 
directory with the same name as one that already exists. As this 
operation will delete the old directory, you will be asked to confirm 
your intention. 


Directory full The specified operation would put more files into a 
directory than it can hold. One solution ts to Make a larger 
subdirectory and copy the files to it. 


Disk drive not present/not configured You specified a disk drive 
that you either have not physically installed in your system or have 
not configured your Utilities diskette to recognize. Make sure that 
your daisy-chain cables are connected securely, and use the System 
Configuration Program (see the chapter The Utilities Diskette) to 
configure your boot diskettes for the proper number of disk drives. 


Error #N_ Internal program error. The number N is returned by the 
language interpreter: see the manual for the language. 


File already exists SOS does not allow two files to use the same 
pathname. The specified operation will create a file with the 
pathname of a file that already exists, or will change the pathname of 
one existing file to that of another. If this happens, you will be asked 
for confirmation, and if you give it, the old file of that pathname will 
be deleted so that the new file can use the pathname. 


File expected This operation works only on files, and you specified 
something that was not a file. 


File or blocked volume expected This operation works only on files 
or block devices, and you specified a character device. 


File or character device expected This operation works only on 
files or character devices, and you have specified something else, like 
a block device. 


File open: access not permitted This error usually occurs when you 
have tried to delete a file that is open for access, such as a program 
that is executing. If you tried to delete SYSTEM.STARTUP from a 
boot diskette while that files program was running, you would get 
this error. 





Formatter device driver not present in system The formatter 
device driver for a drive must be configured into the system before a 
drive can be used for formatting or copying volumes. These drivers 
can be found in the SOS.DRIVER file on the Utilities diskette. 


Illegal disk format for this operation Either (a) you tried to do 
something to a SOS disk that can only be done to UCSD disk, or (b) 
you tried to do something to a UCSD disk that can only be done to 
SOS disks. 


Illegal character in volume name _ The volume name must contain 
only letters, numbers, and periods; the first character must be a 
letter. 


iliegal device name device name must start with a period, followed 
by a letter, followed by no more than 13 letters and numbers. 


Illegal volume name length The volume name must not exceed 15 
characters. 


illegal wildcard Either (a) two wildcards were used where only one 
is allowed, or (b) a wildcard was used when only a single file is 
allowed (e.g., you can’t send a directory listing to multiple files). 


Invalid copy The specified copy operation is impossible: e.g., 
copying a subdirectory to itself. 


Invalid number The number violates a syntax rule: usually, because 
it contains a space or a comma. 


Invalid pathname’ The specified pathname violates the syntax rules 
for pathnames. A common error is more than 15 characters in a local 
name. 


/O error during format operation Unidentified input/output error, 
such as an open drive door, no diskette, or an unformatted diskette. 


/O error Unidentified input/output error, such as an open drive 
door, no diskette, or an unformatted diskette. 


Medium is write-protected or not present The diskette you are 
trying to format or copy onto is write-protected or is not present. If 
you wish to destroy the information on a write-protected diskette, 
remove the diskette from the drive, peel off the small tab that covers 
the write-protect notch, and reinsert the diskette. If the diskette is not 
write-protected, the drive may be configured in but unplugged. 


Not enough memory (too many files atonce) The specified 
directory is too large to load into memory. 


Not enough memory todo copy The volume directory has filled all 
available memory, leaving no room for storing information to be 
copied to another volume. The usual causes are (a) too many device 
drivers configured into the system, and (b) too large a directory to fit 
into memory. The solution may be to remove some drivers from 
SOS.DRIVER . See the Standard Device Drivers Manual for details. 


No room on volume’ The specified operation would try to put more 
information on a volume than it can hold. 


Pathname too long The specified pathname has more than 80 
characters. 


Root directory expected This operation works only on a volume, or 
root directory, and you specified something else (e.g., Verify works 
only on volumes, not files). 


Subdirectory expected This operation works only on 
subdirectories, and you have specified something else. 


Subdirectory not found. The specified subdirectory is not on the 
specified volume or device. 


Unable to read file or directory File or directory contains invalid 
data. 


Volume already on line The specified volume has the same name as 
another volume already in the system. If you copy the Utilities 
diskette to a volume in another drive, then try to read the directory of 
the copy, you will get this error. 





Volume not found (a) The specified file was not in any of the devices 
known to the system. (b) The specified device has no volume in it. 


Write-protect error The file or volume specified is write-protected 
and cannot be deleted or written to. 


General Errors 





SYSTEM FAILURE Indicates a catastrophic failure of SOS, from 
which the only recovery is to reboot your system. System failures are 
rare and usually can be attributed to sudden hardware failure or an 
unknown error in the operating system or language interpreter. If you 
receive the same system failure at the same place in the same 
program more than once, your program has probably encountered an 
error in the language or operating system. Please report such errors 
to your dealer, and fill out a User Input Report, so that they can be 
corrected in a future release of SOS. 


01 : Reentrant system call. 

O02 : Interrupt not found. 

03 : Too many nested interrupts. 
04 : Unable to allocate NMI. 

05 : Event queue overflow. 

06 : Stack overflow. 

07 : Invalid request code. 

08 : Reserved. 

09 : Memory size less than 64Kbytes. 
OA : Invalid volume control block. 
OB : Invalid file control block. 

OC : Invalid allocation blocks. 

OD : Pathname buffer overflow. 
OF : Invalid buffer number. 

10 : Invalid buffer request. 





Care and Handling 


Care of the Apple III 





Treat your Apple Ill as carefully as you would treat a good-quality 
electric typewriter: don’t bump or jar it too much, try to keep it level 
on the surface of a desk or table, and dont spill any liquids on it. 
Even though the Apple Ill is mostly electronic, its mechanical parts 
(such as the disk drive) are delicate, and will become misaligned if 
subjected to physical abuse. 


The Apple Ill has no ventilating fan, and the only way it can dissipate 
heat is through the cooling fins on the back and sides of the case. 
Always be sure your Apple IIIl has adequate ventilation, and that the 
ambient air temperature doesn't get too high. Constant operation at 
high temperature will drastically shorten the lives of the components 
in the Apple Ill. 


Keep the disk drive door closed. An open door is an invitation to dust 


and other foreign particles which could degrade the performance of 
the disk drive. 


Above all, use common sense. Don't drop anything heavy on the 
Apple lll’s keyboard, and don't drop the Apple Ill itself onto anything. 
lf you have obtained the vinyl carrying case for the Apple Ill, use it; it 
was specifically designed to transport the Apple III safely and 
comfortably. If you're going to be shipping the Apple Ill by freight, 
pack it in its original packing material, and make sure it’s packed 
tightly. 





Care of Diskettes 





Never let anything touch the brown or grey surface of the plastic disk 
inside the diskette package. Handle the diskette only by its black 
plastic cover. When a diskette is not in use, keep it in the paper 
envelope it came in. These envelopes are treated to minimize static 
build-up which attracts dust. It is best to store diskettes vertically 
when they are not in use. There are convenient viny! notebooks made 
especially for this purpose. 


Diskettes hold a tremendous amount of information: a single diskette 
can hold over a million bits of information. An individual bit, 
therefore, occupies a very small portion of the diskette. An invisible 
scratch on the surface of the diskette, or even a fingerprint, can 
cause errors. Do not place diskettes on dirty or greasy surfaces; do 
not let them collect dust. 


To write on a diskette label, use a FELT TIP pen or marker, never a 
pencil or ball point pen. Do not press hard. It is best not to write ona 
label attached to a diskette: instead, write on the separate label, then 
attach it to the diskette. 


Keep diskettes away from magnetic fields. This means keep them 
away from electric motors and magnets; they should not be placed 
on top of television sets or other electronic devices. Don't leave them 
on top of the Apple Ill; the magnetic field generated by the 
transformer in the Apple Ill's power supply could erase information on 
the diskette. 





Don't Do This 


Diskettes are sensitive to extremes of temperature. Keep diskettes 
out of the sun, and away from other sources of heat which could 
cause them to warp. On hot days, car dashboards or glove 
compartments can be diskette killers. Diskettes can be damaged by 
temperatures as low as 125 degrees Farenheit (51.7 Celsius), which is 
not very hot. The first evidence of heat damage is a warped or bent 
plastic cover. For optimum long-term storage, keep diskettes at a 
temperature between 60 and 70 degrees Fahrenheit (15 to 20 degrees 
Celsius). 


lf you want to protect the information on your diskette from 
accidental erasure by the Apple Ill, just stick one of the small silver 
adhesive-tape tabs supplied with your diskettes over the rectangular 
notch in the right side of the diskette. When this notch Is covered, the 
computer is prevented from writing any information onto the diskette, 
or changing the information which is already there. To store 
information on the diskette, you must first remove the tab. The write- 
protect tab will not, of course, prevent loss of data due to the 
accidents mentioned above. 


With reasonable care, a diskette will give you an average life of about 
40 operating hours—which is a lot, when you consider the few 
seconds it takes to load a file from a diskette. But with just a little bit 
of carelessness, a diskette may give you no service at all. 





Input/Output Port Specifications 


The following section provides the information you need to connect 
devices to Apple III ports, pin by pin. 





Port A: Joystick Input 


This port contains circuitry for two analog devices (usually 
potentiometers) and two digital devices (usually switches). The 
analog inputs accept input voltage in the range of 0 to +2.2 volts and 
sink 3a input current. The digital inputs are TTL. 


2149 2 4 





1 GND _— Shield ground. 

2 +5 +5 volt power supply. 

3 GND _ Power and Signal ground. 

4 JS1-X Horizontal analog input, read by pdl(2); in Emulation 
mode, equivalent to Apple II Paddle 0 (GCO) input, 
read by PDL(Q). 

5 JS1-B Joystick pushbutton input, read by button(2); in 
Emulation mode, equivalent to Apple II Paddle 0 
button (PB1) input, read by PEEK(— 16287). 

6 +12 +12 volt power supply. 

7 GND Power and signal ground. 

8 JS1-Y Vertical analog input, read by pdl(3); in Emulation 
mode, equivalent to Apple II Paddle 2 (GC2) input, 
read by PDL(2). 

9 JS1-Sw Joystick switch input, read by button(3); in Emulation 


mode, equivalent to Apple Il Paddle 2 button (PB3) 
input, read by PEEK(— 16285). 





Port B: Joystick Input 


This port contains circuitry for two analog devices (usually 

potentiometers) and two digital devices (usually switches). The 
analog inputs accept input voltage in the range of 0 to +2.2 volts and 
sink 3a input current. The digital inputs are TTL. 


Pin 


a @&.3 2. 9] 





Name _ Description 


GND _ Shield ground. 

+5 +5 volt power supply. 

GND Power and signal ground. 

JSO-X Horizontal analog input, read by pdl(0); in Emulation 
mode, equivalent to Apple II Paddle 1 (GC1) input, 
read by PDL(1). 

JSO-B Joystick pushbutton input, read by button(0); in 
Emulation mode, equivalent to Apple || Paddle 1 
button (PB2) input, read by PEEK(—16286). 

+12 +12 volt power supply. 

GND Power and signal ground. 

JSO-Y Vertical analog input, read by pdl(1); in Emulation 
mode, equivalent to Apple || Paddle 3 (GC3) input, 
read by PDL(3). 


JSO-Sw Joystick switch input, read by button(1); not used in 
Emulation mode. 


Here is a sample circuit for a joystick with two potentiometers, one 
pushbutton, and one switch. The value of the potentiometers can 
range from 1K ohm to 700K ohm, although with the higher value, only 
20% of the potentiometer's range will be used. 


9° JSO-SW 


5 JS0-B 








Port C: RS-232-C Serial Interface 





The Apple Ill is classified as Data Terminal Equipment (DTE) under the 
EIA RS-232-C communications protocol. It can be directly connected 
to a piece of Data Communications Equipment (DCE), such as a 
modem. To connect the Apple Ill to another piece of Data Terminal 
Equipment (such as a printer), you must use a modem eliminator. 


All output levels are minimum +6 volts when active and maximum —6 
volts when inactive measured into a 3K ohm load. 


All inputs have a turn-on threshold of +1.25 volts and a turn-off 
threshold of +.8 volts typical. All inputs sink 10mA current. 
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Pin Name Description 


1 SGND Shield ground. 

2 TXD Transmitted data; serial data output from the Apple Ill. 
3 RCD Received data; serial data input to the Apple Ill. 

4 RTS Request to Send output; this indicates that the Apple 


lll is ready to transmit data. 


5 CTS Clear To Send input; this acknowledges that the Apple 
lll may begin transmission. 


6 DSR Data Set Ready input; this acknowledges that the 
remote device is on and operational. 


Pin Name _ Description 


rj GND _ Signal ground. 


8 DCD Data Carrier Detect input; this acknowledges that the 
remote device is ready to transmit data. 


9-19 No connect. 


20 DTR Data Terminal Ready output; this indicates that the 
Apple Ill is on and operational. 


The Color Video Port 





This connector supplies seven different video signals and four power 
supply voltages. Through this connector you can hook up the Apple 
Ill to any NTSC-compatible color or black-and-white video monitor. 
With an additional circuit you can hook up the Apple III to a studio- 
quality RGB-compatible color monitor. 
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Pin Name _ Description 


1 SG Shield ground. 


2 XRGB4 One of four RGB outputs. This (and pins 5, 9, and 10) 
is aT TL output with instantaneous color information. 
A linear-weighted sum of these four signals will form a 
true 16-color RGB video signal (see the circuit below). 


Pin 


11 


12 


14 


15 





Name Description 


SYNCH Composite synchronization signal with negative- 
going sync. 


PDI Not used. 
XRGB1 See pin 2. 
GND Power and signal ground. 


—5V  -5 volt power supply. A device may draw up to 200 
mA through this pin. 


+12V +12 volt power supply. A device may draw up to 500 
mA through this pin. 


XRGB2 See pin 2. 
XRGB8 See pin 2. 


BWVID Black and white composite video. This is an NTSC 
compatible video signal with negative-going sync, 1 
volt peak-to-peak into a 75 ohm load. Color 
information is encoded as a linear grey scale. 


NTSC Composite color video. This is an NTSC-compatible 
video signal with negative-going sync, 1 volt peak-to- 
peak into a 75 ohm load. 


GND Power and signal ground. 


—12V -—12 volt power supply. A device may draw up to 200 
mA through this pin. 


+5V +5 volt power supply. A device may draw up to 1 amp 
through this pin. 


All power supply current ratings assume that no peripheral cards are 
installed in the system. If there are cards in the system, the current 
drawn by those cards counts as part of the total current available 
from each supply. 


The four XRGB signals should be fed to the network shown below. 
The input signals are buffered through emitter-follower circuits, then 
go into a resistor weighting network, which adds the input signals to 
generate the standard color set. The output signals from the resistor 
weighting network are buffered through emitter-follower circuits. The 
resulting RGB-compatible signals can be connected to an RGB 
monitor. The SYNCH signal (pin 3) may also need to be connected to 
the RGB monitor. 





5 +500 TS 
Tit ul 
Tw Tso 
13 | 
Geouwnd 
stv » Sy 
Pri] a +S 
5 
XP 100 
47th Aled 
-Sy Sy i 
270M oe hy 
i] 
MAGE? any og 
. Greer 
By Sy 1 Tei 
} mi 
2a a 
FJ r 
ZAGR4 ati 10 
P P Ble 
‘id ‘ih 
rapt tt ACH 
1 : 
XAG aril 
& a Bea 
Al PHP as DAGCS 
Pi ood Al HPA 
All re ha 
4 pow | Reeviors how 5% 


RGB-Compatible Output Network for Apple III 





The B/W Video Port 





This RCA connector carries the BWVID black and white NTSC- 
compatible video signal (same as pin 11 on the color video 
connector) on its tip and signal ground on its ring. 


The Audio Port 





This miniature phone jack carries a 0.5 volt peak-to-peak audio signal 
on its tip and signal ground on its ring. When a miniature phone plug 
is inserted in this connector, the Apple lil’s internal speaker is 
disabled. 





The Apple II Emulation Diskette | 


The Apple Ill has a feature, called Apple Il Emulation, that allows it to 
run most Apple || software. It does this by imitating, or emulating, the 
behavior of the Apple II. A diskette called the Apple II Emulation 
diskette lets you run programs written for the Apple II Plus (or 

Apple II) on your Apple III computer. While you are using the 
Emulation diskette, none of the advanced features of the Apple Ill are 
available to you: you can only use Apple I! functions. 


When you use the Emulation diskette for the first time, your Apple III 
acts like a 48K Apple II Plus with Applesoft II BASIC, a 16-sector 

Disk Il controller card, and a Serial card. You can also change the 
diskette so that the Apple IIl emulates an Apple II with Integer BASIC, 
or either type of Apple II with a communications card. 


You cannot configure the Apple III to emulate an 
Apple II with a Language Card, an Applesoft Card, or 


an Integer BASIC card. Run-Time Pascal programs 
will run in Apple Il Emulation; programs which require 
the Language Card will not. The section Limitations 
tells what types of Apple II programs will run in 

Apple |i Emulation. 


Apple || Emulation assigns the Apple IlIl’s built-in disk drive to be the 
equivalent of slot 6, drive 1, on an Apple Il; it assigns the first 
additional disk drive to be the equivalent of slot 6, drive 2. Apple Il 





Emulation makes the Apple III's built-in RS-232-C serial port act like 
an Apple II serial card or, optionally, an Apple Il communications card, 
plugged into slot 7 or slot 5. 


Using Applesoft 





You boot the Emulation diskette the same way you boot a normal 
Apple Ill diskette: by inserting it into the built-in drive and pressing 
CONTROL-RESET. After you boot it, you see the boot menu: 


apple I EMULATION MODE 


@EmeN) - BOOT apple X DISK 


- CONFIGURATION MENU 





The Apple !| Emulation Boot Menu 


The Apple || Emulation diskette is initially set up to be used for 
diskettes from an Apple II Plus with Applesoft BASIC and a Serial 
card. To boot an Apple II Plus diskette that uses Applesoft, insert the 
diskette into the built-in drive and press RETURN. Most software for 
the Apple II Plus can be booted in this way. If you want to use Integer 
BASIC, or if your program expects to send information to a 
communications card, read on. 





The Emulation Options 


Boot the Emulation diskette. If your diskette needs Integer BASIC, or 
a communications card, or some other change in the standard setup, 
press ESCAPE to get this menu: 


applic I EMULATION MODE 


= LANGUAGE dl INTEGER BASIC 
CARD : MUNICATIONS 
BAUD RATE ,118 366 . “508 der 
LINE FEED: 
LINE WIDTH: 46 72 86 132 5 CHARACTERS 
CARRIAGE RETURN DELAY ON (aa 


BOOT apple I DISK 
RESTORE OEFAULTS 


SAVE CONE IGURATION 
TO Tran pet DIS 
SELECTION = 





The Apple II Emulation Configuration Menu 


Below the title is a menu with six characteristics, each followed by its 
options. The bottom of the screen shows all the ways to control the 
selection and use of the options. The options that are selected at any 
time are highlighted in inverse video (black on white). 


You can edit this menu with the four arrow keys. Do you see the 
arrow-shaped pointer before the word LANGUAGE? This pointer 
indicates the characteristic whose options you can change. Choose 
the characteristic you need to change with the up- and down-arrow 
keys. The left- and right-arrow keys let you choose the option that 
you need. Once you have chosen the options you want, you can boot 
with the new configuration, or store the configuration on the 
Emulation diskette. 


These are the six different characteristics and their meanings. 


Language: Applesoft Integer BASIC 


Integer and Applesoft BASIC are both emulated as if you are 
using an Apple Il with an Autostart ROM. Integer BASIC 
includes Programmer's Aid #1. Only one language can be in 
memory at a time; to change from one language to the other, 
you must boot the Emulator. 


Card: Serial Communications 


A serial card sends data, usually to a printer; a 
communications card sends and receives data through a 
modem. 


Baud Rate: 110 300 600 1200 2400 4800 9600 19200 


Sets the rate at which the Apple sends and receives data. 
Usually, you'll use 1200 baud (baud means bits per second), for 
compatibility with a Qume printer. 


lf the Card is a Serial card, you can change these additional 
characteristics: 


Line Feed: Enabled Disabled 


ENABLED adds a line feed after a carriage return, needed by 
some printers; DISABLED does not. 


Line Width: 40 72 80 132 CO 


When the LINE WIDTH is set to 40 characters, no line longer 
than 40 characters can be printed by a program. If the program 
prints 40 characters past the last carriage return, the Apple III 
sends out a carriage return to end the line. The options 72 , 80, 
and 132 act similarly; the infinity option adds no carriage 
returns to the program output, no matter how long the line 
gets. 


Carriage Return Delay: ON OFF 


some printers need extra time to return the carriage to the left 
margin. ON provides this delay. 





You can return to the default values for all the characteristics by 
pressing ESCAPE. The default values are the options that are 
highlighted when you first enter the Configuration Menu. 


To boot a diskette with the options that are currently selected (all the 
highlighted options), place your Apple II boot diskette into the built-in 
drive and press RETURN. Doing so does not reset the default values. 


If you want to save the options that are currently selected, press 
RETURN while holding down Closed Apple. The Emulation diskette 
must be in the built-in drive. You may now boot an Apple II diskette by 
pressing RETURN again. 


lf you do not wish to use DOS, you can press the RESET button 
immediately after pressing RETURN. The system will then run in the 
language you choose, without a disk operating system. 


To leave Apple Il Emulation, simply re-boot the Apple Ill with a SOS 
diskette. Insert the diskette and press CONTROL-RESET. 


Limitations 





Apple Il Emulation cannot exactly duplicate the behavior of an 
Apple Il. These are the known limitations: 


Software 


You cannot have both BASIC languages in memory simultaneously. To 
change BASICs, you must reboot the Emulation diskette. 


A number of diskettes have menus, written in one BASIC, that 


call programs written in another BASIC. If you can read the 
CATALOG of the diskette, you find out the name of the 
program you want to run, and which BASIC it’s written in; then 
you can boot with the appropriate BASIC and RUN the 
individual program. This may not be possible with some copy- 
protected diskettes. 


In Apple Il Emulation, you cannot run any Pascal programs that 
require the Language Card when run in the Apple II. However, the 


Pascal Run-Time System lets you run programs like the Tax Planner 
in Emulation mode. The Pascal System on the Apple III runs only in 
Apple IIl mode; however, Apple I! Pascal programs can be recompiled 
to run on the Apple Ill. 


Apple || Emulation is designed to use Apple || DOS 3.3. In order to 
use DOS 3.2 diskettes in the Emulator, you should first update them 
using the FID and MUFFIN programs on your DOS 3.3 boot diskette. 
See your DOS 3.3 manual (or your dealer) for more information. If 
some of your 3.2 diskettes are copy-protected and you can't update 
them to 3.3, you can boot the DOS 3.3 BASICS diskette, then your 
protected diskettes. This alternative requires a good deal of diskette- 
swapping, so update diskettes if you can. 


Peripherals 


You cannot use an Apple Il Language System, an Applesoft II or 
Integer BASIC Firmware card, or most other Apple II peripherals with 
your Apple Ill. 


some Apple II programs require a serial or communications card ina 
particular slot. If this slot is not 7 or 5, these programs will not run on 
the Emulator, unless you put an Apple || serial or communications 
card into the required slot of the Apple Ill. 


The Apple Ill does not have a cassette interface, so the BASIC LOAD 
and SAVE commands, as well as all other commands that use the 
cassette interface, do not work. 


The Apple Ill Emulator has no annunciator outputs. The memory 
locations the Apple Il uses for the annunciator outputs are used by 
the Apple II] Emulator for reading the joysticks. For this reason, any 
program that uses the annunciators at the same time as it reads the 
joysticks gets erroneous joystick readings. 


Game Inputs 


The Apple Iii does not have an Apple I! Game I/O connector, but the 
Emulator recognizes the Apple Ill joysticks as game paddles. The 
table below shows the relationships between the Apple III joystick 
inputs and the Apple Il game-paddle inputs. 





Relationship Between Emulation Mode Joysticks 
and Apple Il Game Paddles 


Analog Inputs (Potentiometers) 





Apple II! Apple I! 


SOS 
Port/Pin Direction Name AlllBASIC Paddle AllName Applesoft BASIC 


B/4 Horiz JSO-X pdi(0) 1 GC1 PDL(1) 
B/8 Vert JSO-Y odi(1) 3 GC3 PDL(3) 
Al4 Horiz JS1-X pdi(2) 0 GCo PDL(0) 
A/8 Vert JS1-Y pdi(3) 2 GC2 PDL(2) 


Digital Inputs (Pushbutton and Toggle Switches) 





Apple II! Apple I! 


SOS 
Port/Pin Direction Name AlllBASIC Paddle AllName Applesoft BASIC 


B/5 Button JSO-B button(0) 1 PB2 PEEK(—16286) 
$C062 

B/9 Switch JS0-SW ~ button(1) 3% PBO* PEEK(—16288)* 
S$CO60* 

A/5 Button JS1-B button(2) 0 PB1 PEEK(— 16287) 
$C061 

AQ Switch JS1-SW  button(3) 2 PB3 PEEK(— 16285) 
$C063 


* Note that on an Apple Il, Paddle 3 cannot have a pushbutton, as 
memory location $CO60 is used for cassette input. Any program that 
reads this location as a pushbutton input works in Emulation mode, 
but not on an Apple Il. 


The Apple Ill Emulator uses a modified form of the Autostart ROM's 
paddle-reading routines, PDL(0) through PDL(3) in BASIC, to read 
the joysticks. Any Apple || program that uses its own routines for 
these functions will not run on the Emulator. 


Video 


The Apple III's RGB color video outputs do not generate a color 
signal for High-Resolution Graphics in the Emulator. Apple Ii High- 
Resolution images are available only on the NTSC black and white 
and color video outputs. 


Dots on the left border of the high-resolution graphics screen flicker 
uncontrollably. 


Firmware and Hardware 


The subroutines in the Apple Il’s monitor ROM that handle Non- 
Maskable Interrupts (NMIs), annunciators, cassette input and output, 
and paddle input have been altered. The NMI vector in the Emulator 
is the same as the Reset vector. Cassette input and output have been 
removed and are inoperable. 


The RESET button on an Apple Ill in Emulation mode does not 
operate the same as the Apple II RESET button in that it generates a 
Non-Maskable Interrupt, not a true reset. Holding down CONTROL 
while pressing RESET causes the Apple Ill to attempt to boot a 
diskette. 


Keyboard 
The symbols 
Oe A ele is ese ey 
in the Apple II character set have been relocated on the Apple III 
keyboard. Although these symbols can still be generated by the 


keyboard, different keystrokes are required to generate them. 


Several keys on the Apple IIl Keyboard produce characters the 
Apple Il keyboard cannot produce. When they are sent to the 





Emulator’s screen, different characters are displayed. The table below 
shows the characters produced by these keys, followed by the 
characters displayed, for all combinations of the SHIFT and 
CONTROL keys. Some of these characters are not displayed at all 
(the cursor does not move): these are denoted (ND) below. Others 
display as spaces (the cursor moves one space): these are denoted 
(SP) below. The two- and three-letter abbreviations are the ASCII 
symbols for control characters. 


Key Alone CONTROL SHIFT Both 





Char Disp Char Disp Char Disp Char Disp 

— - : . - — — US (ND) 
| \ \ FS (ND) | < DEL ? 

[{ | ESCAPE (ND) { ESCAPE (ND) 

I} | | GS (ND) } = GS (ND) 
(SP) ° (SP) =- > = 


Some programs may give unexpected responses if 
they receive characters not in the Apple I! character 
set. CTRL-SHIFT-2 on the Emulator (CTRL-SHIFT-P on 
the Apple Il) produces ASCII NUL ($00), which halts 
many programs. CTRL-S on both machines suspends 
screen output until pressed a second time. 


A Word of Advice 


We don't recommend writing programs that exploit quirks of 
Emulation mode, such as the Paddle 3 button input, that are absent 
on the Apple II or Apple II Plus. If you want to write a program that 
runs only on the Apple Ill, Apple Ill Business BASIC will probably 
serve you better than Applesoft or Integer BASIC. If you want to write 
a program that runs in Emulation mode, it will be more useful if you 
write it so that it will run on either the Apple II or Apple Il Plus. 


System Specifications 





Operating System 


Version: SOS 1.1 
Classification: 


Single-task, configurable, interrupt-driven operating system. 
File system—hierarchical, tree file structure. 
Device-Independent |/O. 


CPU Architecture: 


Address enhanced 65@2 instruction set. 

Supports both bank-switched and enhanced indirect 
addressing. 

Separate execution environments for user and SOS including 
private zero and stack pages. 


System Calls: 


Based on 6502 BRK instruction, pointer, and value parameter 
types. 

Error codes returned via A register. 

All other CPU registers preserved upon return. 

Optional parameter lists for future expansion. 


File Management System: 


Hierarchical file structure. 

Pathname prefix facility. 

Byte oriented file access to both directory/user files and device 
files. 

Dynamic, non-contiguous file allocation on block devices. 
Automatic buffering (current index block and data block). 
Dynamic memory allocation of file buffers. 

Block size (512 bytes). 

File protection: rename/destroy/read/write access attributes. 
File level assignment on Open. 

Automatic date/time stamping of files. 

Automatic volume logging/swapping, supported by system 
message center. 

Multiple volumes per block device can be “open” 
simultaneously. 

Sparse file capability. 


maximum # of active volumes = 8 

maximum disk size = 32 Mbytes 

maximum user file size = 16 Mbytes 
maximum file entries in volume directory = 51 
maximum file entries in a subdirectory = 1663 
file names—maximum 15 characters 
pathnames—maximum 128 characters 


File system calls: 


Create New_line 
Destroy Read 
Rename Write 
Set_file_info Close 
Get_file_info Flush 
Volume Set_mark 
Set_prefix Get_mark 
Get_prefix Set_eof 


Open Get_mark 


Device Management System: 


Block and character device classes. 

Standardized interface for block and for character devices. 
All devices are named and configurable. 

Support for synchronous, interrupt, and DMA-based |/O. 


maximum number of devices = 24 
maximum number of block devices = 12 


Device system calls: 
Get_dev_num D_status 
D_info D_control 


Memory/Buffer Management System: 
All memory allocated as segments. 
Supports maximum of 512 Kbytes RAM. 
System buffers allocated and released dynamically. 
System buffer checksum routine for data integrity. 


Memory system calls: 


Request_seg Get_seg_info 
Find_seg Get_seg_num 
Change_seg Rel_seg 


Additional System Functions: 


System clock/calendar 

(year/month/day/week day/hour/minute/second/ms). 
Joysticks: reads X and Y axis, pushbutton, and switch. 
Clean system termination via coldstart routine: clears memory. 


System calls: 


Set_time Cold_start 
Get_time 


interrupt Management System: 


Receives hardware interrupts (IRQ, NMI) and system calls 
(BRK). 

Hardware resource allocation and deallocation. 
Dispatches to driver interrupt handlers. 


Event Management System: 


Priority based event signaling. 

Event handlers preempted by higher priority events. 
Events with equal priorities process FIFO. 

Event fence delays events with priority < fence. 


Event system calls: 
Set_fence Get_fence 


SYSTEM CONFIGURATION: 


Menu-driven system-configuration editor (System 
Configuration Program). 

Can add, remove, and modify drivers and can select the 
keyboard-layout and system-character-set tables. 


Standard Device Drivers: 
Floppy (.D1, .D2, .D3, .D4) 
143,360 bytes (formatted) per volume. 


Automatically reports mounting of a new volume. 
Built into SOS kernel. 





Console (.CONSOLE) 


Interrupt-driven keyboard (supports type-aheaq). 
Configurable keyboard-layout table (via SCP). 
Raw-keystroke and no-wait input modes. 
Event handler supports anykey and attention character. 
Optional screen echoing. 
Console control modes: 

video on/off 

flush type-ahead buffer 

suspend screen output 

display control characters 

flush screen output 


Cursor positioning commands. 

Viewport set, clear, save, and restore commands. 
Horizontal and vertical scrolling. 

Text modes: 24x80 and 24x40 B&W and 24x40 color 
(normal and inverse). 

Configurable system character set table (via SCP). 
Character set can be changed under program control at 
any time. 

Screen read command. 


Graphics (.GRAFIX) 


Displays graphical and textual information 

simultaneously. 

Graphics modes: 560x192 and 280x192 in B&W video. 
280x192 and 140x192 in 16 colors. 

Point-plotting and line-drawing commands using 

graphics viewport and pen. 

Raster block picture operations. 

Color operator table, controls color overwrite. 

Transfer modes allow binary operations on the drawing 

color and the current screen color. 

Allows use of either the system character set or an 

alternate character set to display ASCII text on the 

screen. 

Single or dual graphics screens. 


General purpose communications (.RS232) 


RS-232-C interface. 

Configurable data rates from 110 to 9600 baud. 
Configurable protocols, including XON/XOFF, ETX/ACK, 
and ENQ/ACK. 

Interrupt-driven, buffered, bi-directional data transfer. 
Hardware handshaking option. 


Serial printer (.PRINTER) 
RS-232-C interface. 
Configurable data rates from 110 to 9600 baud. 
Interrupt-driven and buffered (output only). 
Hardware handshaking option. 

Audio (.AUDIO) 
64 volume levels. 


Produces tones from 31 to 5090 Hz (over 7 octaves). 
Duration range from 0 to 5 sec (increments of 1/60 sec). 


Hardware 





Size: 17.5 inches wide (44.45 cm) 
18.2 inches deep (46.23 cm) 
4.8 inches tall (12.19 cm) 
Cast aluminum base with molded plastic cover 


Weight: 26 pounds (11.8 kg) 
Processor: Based on the 6502B microprocessor, with extended 
addressing capability 


Clock Speed: 2 MHz peak, 1.4 MHz average 


Main Memory: 128K (98,304) eight-bit bytes 
Dynamic Random Access Memory 


ROM Memory: 4K (4,096) eight-bit bytes initialization and diagnostics 


Power Supply: High-voltage switching type 
+5, —5, +12, —12 volts 
UL approval pending 


Power Req: 100 watts maximum, 107 to 132 volts, 60 Hz. 


Ambient Temp: 15 to 35 degrees Celsius. 
Critical factor is deformation temperature of diskette 
cases. 


Mass Storage: One 5.25 inch (13.33 cm) floppy disk drive. 
built-in 140K (143,360) bytes per diskette. 
Up to 3 additional drives can be connected by “daisy 
chain” cables. 


Keyboard: 74 keys (61 on main keyboard, 13 on numeric pad) 
Full 128 character ASCII represented 
All keys have automatic repeat except modifier keys 
Five modifier keys: SHIFT, CONTROL, ALPHA LOCK, 
and two program-definable “Apple” keys 
Four directional arrow keys with two-speed repeat 
Four other special keys: TAB, ESCAPE, RETURN, 
ENTER 


Screen: Three text modes: 
40x24, black and white, normal and inverse 
80x24, black and white, normal and inverse 
40x24, 16 color, foreground and background 
All text modes have a software-definable 128- 
character set 


Four graphics modes: 
280x192, black and white 
280x192, 16 color, foreground and background 
140x192, full 16 color 
560x192, black and white 


Video Output: RCA phono connector for NTSC black and white 
composite video 
DB-15 type connector for: 
NTSC black and white composite video 
NTSC color composite video 
RGB pure video 
Composite sync signal 
+5, —5, +12, —12 volt power supplies 
Color signals appear as 16-level grey scale on black 
and white video outputs 


Audio Output: Built-in 2-inch speaker 
Miniature phone-tip jack on back of Apple III 
Three different audio generators: 
64 level audio port (6-bit DAC) 
One-bit square-wave generator 
Fixed-frequency “beep” generator 


Serial |/O: RS-232C compatible, DB-25 female connector 
software selectable baud rate and duplex mode 


Joysticks: Two DB-9 connectors for two joysticks, two 
pushbuttons, and two switches 


Printer: One DB-9 connector (shared with first joystick) for 
“Apple Silentype” printer 


Expansion: Four 50-pin expansion slots inside the cabinet 





argument In general, a mathematical expression affected by 
some function. In the sentence, “Multiply six by eight” six and eight 
are arguments. Specifically in the context of programming for SOS 
drivers, arguments are additional data that follow commands and are 
necessary to their action. 


audio driver The device driver that enables a program to produce 
sounds with the Apple Ills built-in speaker. 


back up To make a copy for safe keeping. In the event of a power 
failure, data writing errors, or a careless mistake that destroys 
information on a disk, a backup copy can save you much time and 
grief. 


backspace To move the cursor one character to the left. There are 
two types of backspaces: destructive, which remove characters 
backspaced over from the screen; and non-destructive, which leave 
all characters intact. 


block A unit of information 512 bytes long. The Utilities List 
command reports the sizes of disks and files in blocks. 


block device A device that uses one block (512 bytes) of 
information as Its basic unit of communication. 


boot diskette A diskette containing all the programs and data 
that the Apple Ill needs to use a language and to communicate with 
at least some of its devices. When turned on with a boot diskette in 
the built-in drive, an Apple III will automatically start using the 
language on the boot diskette. 


bootstrap or boot To get the system running. When you turn the 
system on, you need a “boot diskette” to get it running. 


built-in Within the Apple III's case. The Apple III has a built-in 
speaker, disk drive, serial interface and so on. 


catalog A list of the contents of a directory, typically a list of 
pathnames. 


character Any symbol that has a widely-understood meaning. The 
Apple Ill has 128 different symbols in its character set. Some, such as 
letters, numbers, and punctuation, can be displayed on the monitor 
screen, and printed on a printer. Others are used to control various 
functions of programs or the Apple Ill (see contro! characters). 


character device A device that uses one character (1 byte) as its 
basic unit of communication. The console and Silentype printer are 
both character devices. 


command 1. Something you type at the keyboard to make the 
computer do something. For example, Copy in the Utilities program is 
a command. 2. In the context of programming to control devices, a 
character (usually a control character), embedded in the stream of 
characters sent from a program to a device driver, to instruct the 
driver to perform some function. 


configure As used in this manual, to change the parameters of a 
driver with SCP to adapt SOS to some device or the like. 


configuration The hardware and software arrangement of a 
system. Specifically, the configuration of SOS (which see) consists of 
its active drivers and their default parameters, and determines how 
the Apple Ill communicates with the console, disk drives, and other 
devices. You control the configuration of your system with SCP 
(which see). 


connector The physical joining place for electrical or electronic 
devices. The back of the Apple III has connectors for a Silentype 
printer, a joystick, a serial interface, two video connectors and an 
audio printer. A connector is sometimes called a port. 





console The Apple Ill’s video display and keyboard together make 
up the console. This is the part of the Apple Ill you communicate with 
directly. 


console control keys: You can use the 5,6,7,8, and 9 keys on the 
numeric keypad while holding down the CONTROL key to control 
output to the console. 


console driver The program that enables the operating system of 
the Apple Ill to communicate with the console. It controls the reading 
of characters from the keyboard (with typeahead), cursor motion, and 
the display of text on the monitor screen. 


control character A symbol you can create by pressing one of the 
Apple's keys while holding down the key labelled CONTROL. These 
symbols are not usually printed and are generally used to control 
computing functions; hence the name. Control characters can also 
be generated and transmitted by programs. 


cursor The symbol, typically a white rectangle, that moves across 
the screen and indicates where editing and similar action will take 
place. 


device A piece of computer hardware, such as a disk drive or 
monitor, other than the computer itself. Devices may be built-in 
devices or they may be external (also called peripheral) devices. 


device driver The program that acts as a communications link 
between a device and the operating system. Before you can use a 
new device with your Apple Ill, you must use the System 
Configuration Program on the Utilities diskette to install and 
configure the driver for that device. The use of device drivers is 
described in the Apple /// Standard Device Drivers Manual. 


device name The name used in SOS pathnames to refer to a 
particular device, without regard to what files are associated with the 
device. Device names begin with a period and a letter, followed by up 
to 14 alphanumeric characters. For example the device name of the 
disk drive built into the Apple Ill is .D1 regardless of what diskette is 
in the drive. 





directory A file that contains the names and locations of other 
files. These other files may themselves be directories, in which case 
they are called subdirectories. The list of the contents of a directory 
file is sometimes called a catalog. 


disk A device for storing computer files that consists of a plastic 
metal disk coated with metal oxide that works the way metal oxide on 
recording tape works. Hard disks (which see), floppy disks (which 
see) and diskettes (which see) are kinds of disks. You must format a 
disk with the Format program on the Utilities diskette before the 
Apple Ill can write to or read from it. 


disk drive The complete machinery and electronics that turn and 
read a disk, and receive and transmit files in a manner intelligible to a 
computer (to a device driver in the case of an Apple Ill). 


diskette A 5-1/4-inch floppy disk, or smaller. Remember not to 
touch the magnetic surface of a diskette; handle it only by its plastic 
cover. 


echoing Characters typed on the keyboard are sent first to the 
operating system, and then the operating system displays the 
characters on the monitor screen. It is the operating system echoing 
the keypresses that makes characters appear on the screen when you 
type. 


external Not within the Apple's case. Usually used to refer to 
devices that are not built-in. The Apple III can have as many as three 
external disk drives. Synonym: peripheral. 


file An orderly, named collection of information. The information 
you work with on your Apple Ill is stored in files named and organized 
by SOS. SOS files are usually stored on a disk. Each file on a disk is 
identified by a pathname (which see) unique to that disk. SOS 
organizes names and locations of files into a special type of file 
called a directory. The files in a directory may include subdirectories 
of other files on the disk. 


file name see pathname. 





floppy disk A disk made of metal-coated flexible plastic sealed in 
a protective envelope. Floppy disks are typically slower in response 
and smaller in storage, but cheaper and more portable than hard 
disks. 


format To prepare a disk for use. When you format a disk by using 
the Format program on the Utilities disk, the Apple puts a magnetic 
outline for the storage of information onto the surface of the disk. 
You must format a disk before the Apple can write on it. Note: When 
you format a disk, all information that was previously on the disk is 
destroyed. 


graphics driver A program that enables the Apple's operating 
system to communicate with the portions of memory designated as 
the storage areas for graphics (the graphics screens). The graphics 
driver allows you to plot points, draw lines, display characters, and 
place blocks of pre-defined shapes on any of the four graphics 
screens. It also allows you to read the setting of any dot on any 
graphics screen. 


graphics modes The formats, in terms of color and resolution, of 
Apple Ill graphics. 


hard disk A disk made of hard metal and sealed into a drive, or 
cartridge. Hard disks are typically faster in response and larger in 
storage, but higher in price and less portable than floppy disks. 


initialization 1. The effect of the startup routines that 
automatically run when you turn on your Apple Ill. These routines 
reset all devices, clear the screen, set the character set, perform a 
diagnostic check of some of the Apple Ill’s hardware, and load an 
operating system from the built-in drive. 2. The preparation of a disk 
for use. See format. 


input/output (I/O) 1. A general term referring to the transfer of 
information between the Apple Ill and any device. 2. The information 
transferred between the Apple Ill and any device. 


interpreter A program that translates each step in a high-level 
language (such as BASIC) into a series of low-level machine 
language operations and then carries out those operations before 
proceeding to the next step. 


joystick A stick or lever whose motion controls the direction of 
movement of cursors and other computer functions. 


Kernel In the Apple III, the part of SOS that directs the flow of 
information within the Apple III and among its devices. 


list Averb in computer jargon, meaning to display on a monitor or 
print on a printer, the contents of the computer memory or a file. 


load To bring into memory. When you turn on the Apple Ill, an 
operating system is loaded from the boot disk. You can also load 
alternate character sets, device drivers, and files. 


local name The name of a file, directory, or subdirectory that 
omits the volume name (which see) for convenience. For example, the 
pathname /ACCOUNTING/PAYABLE/QUIGLY consists of three local 
names: ACCOUNTING, PAYABLE, and QUIGLY, naming a directory, 
subdirectory and file, respectively. You can only get at the file QUIGLY 
using its local name if the prefix is set to /ACCOUNTING/PAYABLE, 
otherwise you must use its full pathname. 


memory The storage for programs and information that is inside 
the Apple IIl’s case. Your Apple Ill has 4K bytes of permanent memory 
that contains initialization and diagnostic programs and a much 
larger memory (specified for each machine) for general use. Every 
time the Apple Ill accepts data from a device, information is stored 
into memory. 


menu A list of choices. A program typically displays a menu on 
the monitor screen, and then waits for you to choose one of the items 
by name or number. 


numeric keypad The thirteen keys on the right side of the 
keyboard. The symbols generated by these keys are normally the 
same as the symbols generated by the corresponding keys on the 
main keyboard (ENTER is the same as RETURN); however there is a 


way to tell if the key pressed is on the numeric keypad. Refer to the 
Apple I! Standard Device Drivers Manual for more details. 


off-line A device that SOS could communicate with but presently 
cannot is said to be off-line. A device is off-line if it is not connected 
to the Apple Ill or if it is connected and not turned on. A disk drive, for 
example, is off-line if it has no disk in it, or if the door is open. 


operating system A program that supplies mediating services 
between computer hardware and a user or users’ program. The 
operating system of the Apple Ill is called SOS (which see). 


pathname The full name by which SOS identifies a file. A 
pathname is a sequence of local names, each preceded by a slash, 
that specify the path you take from directory to directory to gettoa 
certain file. A pathname always begins with a volume name and ends 
with the local name of a file. The pathname 
/ACCOUNTING/PAYABLE/QUIGLY identifies QUIGLY as a file on the 
volume (usually a disk) ACCOUNTING, in the directory PAYABLE. 


prefix A pathname that specifies all or part of a pathname. You 
can get at all files within the directory named by the prefix simply by 
mentioning their local names. For example, if you use the SCP’s 
Prefix command to set the prefix to /ACCOUNTING/PAYABLE you can 
use the local name QUIGLY to get at 
/ACCOUNTING/PAYABLE/QUIGLY. Then to specify a file in another 
directory, for example /ACCOUNTING/RECEIVABLE, you must use 
either its entire pathname or change the prefix. Device names do not 
require a prefix. 


peripheral Shortened form of peripheral device. A device that is 
not within the Apple III's case. Synonym: external device. 


printer driver The device driver that enables the Apple Ill's 
operating system to communicate with a printer. 


resolution The size and density of the small dots that form 
characters and other images on the screen. 


root directory The main directory of a volume. The root directory 
is identified by the name of that volume. For example, the root 
directory of the disk called ACCOUNTING is /ACCOUNTING . 


System Configuration Program see SCP. | 


SCP The SCP (System Configuration Program) is a program 
which allows you to add and delete device drivers, change their 
parameters, and create and organize files. 


scroll To move all the information within a window on the monitor 
screen to create room for the display of additional information. When 
the cursor is on the bottom line of the monitor screen, and you press 
RETURN to enter a new line of text, the display scrolls upward one 
line, and the cursor moves to the head of the new bottom line. 


serial interface Electronics in the Apple III that allow the Apple III 
to send and receive information to any device that understands serial 
information. Serial information travels through wires one bit at a time. 


SOS (pronounced “sauce’”) The Apple Ill’s Sophisticated 
Operating System. It provides the means for programs to use the 
hardware of the Apple Ill and peripheral devices. Aversion of SOS is 
included on every boot disk for the Apple Ill. You can change (or, 
configure) SOS, with SCP, to accomodate various devices for use 
with your Apple Ill. See operating system. 


start up To turn on the Apple Ill. See initialization (1). 


subdirectory A file that contains the local names and locations of 
other files and that is not the root directory. Every subdirectory has 
its local name listed in a root directory, or in another subdirectory. 


system character set A set of characters of a particular shape 
and style displayed by the console and graphics drivers including 
their shape and style. You can change sets with the Standard 
Character Set Option of the System Parameters display of SCP. 


system configuration see configuration. 


system parameters Special information that is stored on every 
boot disk, such as the number of disk drives that the system is 
configured to use. System parameters can be changed using the 
System Configuration Program on the Utilities disk. 





text Printed information that a person types or will read. 


text mode The size and format of the text screen. 


type-ahead A feature by which the Apple IIIl remembers all of the 
keys you press, even if it is busy doing something else (such as 
writing to a disk). If the Apple III is busy the characters you press may 
not immediately appear on the monitor screen, but they will not be 
ignored. 


turnkey diskettes Diskettes that execute a specific program when 
booted. For example, the Demonstration disk that comes with the 
Apple Ill is a turnkey diskette. 


volume A general term referring to a mass storage device. The 
volume most commonly used with the Apple III is the diskette. A 
volume has a name, a root directory with the same name, and its 
information is organized into files. Each volume the Apple Ill is using 
at one time must have a different volume name. 


volume name The name of a volume, usually a disk. This name is 
also the local name of the main, or root, directory of the volume. 


wildcard When specifying pathnames to the Filer of SCP, you can 
use the character = (equal sign) to represent common characters 
shared by several file names. The equal sign thus used is called the 
wildcard character. 


wraparound The feature that causes the cursor to automatically 
jump to the beginning of the next line whenever it reaches the right 
edge of the screen, . 
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diskette 7 ff. 

menu 8 
destination volume 45, 86 
destroying 

volumes 46 

information 46 
destructive backspace 20, 22 
device 


drivers 12,49, 101 
names 29 
file 30 
Device Menu 43, 84 
devices 2/ 
operations on 41, 84 
diagnostic 
checks 113 
messages 113 


DIAGNOSTIC message 7,113 
dimensions, Apple Ill 152 
directories 31, 64, 72 

volume 31, 82-83 
directory example 64-69 
disk drive 

connector 

door 5 

names 29 

installation 9, 53, 101 ff. 
disk-switch message 56 
diskette 

care 3, 124-126 

copying 45, 85-87 

duplication errors 87, 90-91 

image 82 

insertion 4-5 

label 5, 124 

life 126 

request, SOS 56 

storage 124-126 


103 


diskettes 

backup 42 

boot 12 

formatting new’ 57, 61 
display, video (see video display) 
Down-arrow 9/7 
driver file 

reading errors 50, 116 

use of 51 
dummy cards 108 
duplicate volume names _ 55, 59 


E 
echoing 15 
edge, right 23 
editing feature summary 96 
editing input 93 
electrical specifications 
Emulator, Apple Il 137 
ENTER key 18, 97,99 
entering 
information 16 ff. 
into fields 93-94 
numerical information 17 
equal sign(=) 97 
erasing mistakes 
20-23, 45, 79, 93-94 
error messages 113 
ESCAPE key 96, 99 
extension cords 2 
external devices, installing 101 ff. 


127 Ff. 


F 

field editing 78,93 
fields 58 

File Menu 63 

file 


names 371 ff., 72 ff. 

patterns 74,94 

handling commands 63 
Filer 693 ff. 


filererrors 117 
files, 30,38 

operations on, 
fins, aluminum 102 
FLOPPY DISKS 101 
Format-volume command 5/7 
61, 88 
formatting 

errors 11/7 ff. 

new diskettes 42, 57 ff. 
front, Apple Ill 99 


G 


generalerrors 121 
generating new system 53 


41, 69 


graphics 
modes 151, 153 
driver 49 


specifications 151 
grave accent 1/7 


H 
handling 
diskettes 3, 124 
peripheral cards 101 
handson 11 
hard disk instalation 104 
hardware specifications 152 
heat dissipation 102 
high-speed repeat 25 
highlighting 58 
home keys 1/7 


! 
(O ERROR message 
image, diskette or volume 82 
initialization 
of diskettes (see formatting) 
of Apple Ill (see startup) 
input field editing 93-94 
input/output devices 27, 48, 63 


inserting diskettes 4 
installing 
printer 49 
disk drives 9, 53 
peripheral devices 101 ff. 
interface 
cards 107 ff. 
serial 105 
internal disk drive 4 
interpreter 13 
invalid system configuration 54 


J 
joysticks 104, 128 ff. 


K 
Kernel, SOS 
keyboard 
description 16, 99 
specifications 153 
keystrokes 


L 
labels, diskette 124 
language 13 
leaving demonstration 25 
Left-arrow key 

(backspace) 20, 96, 97 
limitations of Apple Ill Emulation 
List-devices command 91 
List-files command 70 
loading operating syste 12 
localnames 31 
lowercase letters 31 


M 

machine language 2/7 
machine, the 99 
Main Menu 63 


Make-subdirectory command 
64-65, 79 
mass storage 39, 69, 104 
memory specifications 153 
menu 
selection 93 
Configuration 50 
Demonstration 15 
Device 43, 58 
File 63 
Main 41,58 
microprocessor 152 
mistakes 20-23, 45, 79, 93-94 
Monitor Ill 7 
monitor, Sanyo 7 
monitor, video (see video monitor) 
mounting the Apple Ill 111 


N 

new diskettes, formatting 57, 61 
noise (of disk drive) 100 
nondestructive backspace 20 
number of disk drives 53 
numeric keypad 17, 100 


O 
one, character and key 18 
Open-Apple key 21,99 
Open-Apple-| 96 
Open-Apple-Left-arrow 96 
Open-Apple-Right-arrow 96 
operating system 12 
specifications 14/7 
overstriking 20 


Pp 

packing lists 1 

partial pathnames 37 

Pascallanguage 141 
summary 97 


pathnames 32,35 
and prefix 37 
duplicate 78, 80 


partial 37 
selection 77, 94 
period (.) 


indevice names 29 
inlocalnames_ 31 
peripheral 
connectors 108 
cards 107-110 
devices (see external devices) 
slots 102 
/PERSONNEL diskette 64 
physical specifications 152 
plugging in 1 
plus-or-minus sign 1/7 
port(s) 101 ff, 132 ff. 
power 
connector 103 
cord andplug 1,2 
supply 112 
switch 6, 102 
prefix 3/7, 81 
printer 
driver 49 
port, Silentype 104 
specifications 
installation 49, 101 


use of 73 

processor 152 

programming languages (see 
languages) 

protecting information 44, 80, 125 


Q 


Qume printers 101 


R 


raspy noise (of disk drive) 
reading 
directory 64 
driver files 50 
recording information 4 
red light (disk drive) 6, 100 
removing 
diskettes 5 
peripheral cards 109-110 
cover 106-107 
Rename-files command /7/ 
Rename-volume command 88 
repeating keys 25 
replacing cover 112 
RESET button 12 
RETRY message / 
RETURN key 24, 96, 97, 99 
retype key 20 
RGB monitor 132 
Right-arrow key (retype key) 
20, 96, 97 
ROM memory 153 
RS-232-C 
interface 101, 131 
driver 49 
rugs 102 


S 

Sanyo monitor 7 

SCP errors 116 

SCP (see System Configuration 
Program) 

screen 
edge 23 
specifications 

scrolling 23, 24 

security mount 111 

serial 
/O specifications 152 
interface port 105 


100 


set-Prefix commmand 37, 81 subdirectories 32, 37, 64 
set-Time command 92 swapping diskettes 47-48, 56-5/ 
set-Write-protection command 80 System Configuration Program 
setting 28, 48 ff. 

date 92 system 

time 92 generation errors 116 
Shakespeare 20 parameter-editing errors 116 
SHIFT keys 18, 21, 99 parameters 52 
Silentype SYSTEM FAILURE error 

printer port 104 message 121 

driver 49 

use of 73 ¥ 
silver tabs 125 TAB key 99 
size, Apple Ill 152 temperature 125, 153 
slash (/) text modes 151, 153 

inpathnames 32 tilde 17 

through zero 18 transporting Apple III 


slots, peripheral (see peripheral) turning power off 8 
Sophisticated Operating System turnkey systems 13 


(see SOS) type-ahead demonstration 25 
SOS 2/7 types, file 71 
errors 114 typing on the keyboard 17 ff. 
Kernel 115 typographical errors 20-23 
message system 56 
specifications 147 U 
SOS.DRIVER file 52-55, 115 unpacking 1 
SOS.INTERP file 115 up-arrow key 97 
SOS.KERNEL file 115 updating SOS 
source volume 45, 86 uppercase letters 31 
speaker 111 using 
special keys 18 devices 2/7 
specifications files 938-39 
operating system 147 Utilities diskette 28, 41 ff., 63, 93 
hardware 152 Main Menu 93 
standard device drivers 49 
starting up 6 V 
startup VADER, destruction of 87, 89 
errors 113 validation 54 
routines 11 Verify-volume command 90 


vertical bar 17 


video W 
cable 2,3 weight, Apple Ill 
monitor 


Widget example 33 
wildcards 74-75, 96 
wrapping 23 
write-protecting 
diskettes 125 


adjusting 7 
connecting 2,3 
output specifications 154 

port 
black-and-white 135 


files 44, 80 
| color 132-134 volumes 44 
volatile memory 9 error 80 


volume(s) 5/7 


and devices 84 xX 
copying 85 

image 82 y 
names 55, 57, 59 

random names 89 Z 


zero (vs.0) 18 
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